> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get records from a specific list

> Retrieves all records that belong to a specific list with pagination



## OpenAPI

````yaml /api-reference/openapi.json post /v1/lists/{id}/records
openapi: 3.0.0
info:
  description: >-
    REST API for accessing and managing your Nex data. Generate API keys from
    the Nex web UI and use them to authenticate requests.
  title: Nex Developer API
  contact: {}
  version: '1.0'
servers:
  - url: https://app.nex.ai/api/developers
security: []
paths:
  /v1/lists/{id}/records:
    post:
      tags:
        - Lists
      summary: Get records from a specific list
      description: Retrieves all records that belong to a specific list with pagination
      operationId: getListRecords
      parameters:
        - description: List ID
          name: id
          in: path
          required: true
          schema:
            type: integer
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/developer.ListRecordsRequest'
        description: List records request with pagination options
        required: true
      responses:
        '200':
          description: List of records with pagination info
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/developer.ListRecordsResponse'
        '400':
          description: Bad request - Invalid parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/httpx.APIError'
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/httpx.APIError'
        '404':
          description: List not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/httpx.APIError'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/httpx.APIError'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    developer.ListRecordsRequest:
      type: object
      properties:
        attributes:
          $ref: '#/components/schemas/developer.AttributesParam'
        limit:
          type: integer
        offset:
          type: integer
        sort:
          $ref: '#/components/schemas/developer.SortParam'
      example:
        attributes: all
        limit: 50
        offset: 0
        sort:
          attribute: name
          direction: asc
    developer.ListRecordsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/developer.RecordResponse'
        limit:
          type: integer
        offset:
          type: integer
        total:
          type: integer
      example:
        data:
          - id: '32414268188027655'
            object_id: '32414268188027650'
            type: person
            workspace_id: '32414268188027645'
            created_at: '2024-01-15T14:20:00Z'
            updated_at: '2024-01-20T09:15:00Z'
            attributes:
              name:
                first_name: Alice
                last_name: Johnson
              email_addresses:
                - alice@techcorp.com
              job_title: Product Manager
              phone_number:
                country_code: 1
                number: '5551112222'
          - id: '32414268188027656'
            object_id: '32414268188027650'
            type: person
            workspace_id: '32414268188027645'
            created_at: '2024-01-16T08:30:00Z'
            updated_at: '2024-01-16T08:30:00Z'
            attributes:
              name:
                first_name: Bob
                last_name: Wilson
              email_addresses:
                - bob@startup.io
              job_title: Founder
              location:
                city: San Francisco
                region: CA
                country: US
        limit: 50
        offset: 0
        total: 247
    httpx.APIError:
      type: object
      properties:
        code:
          type: integer
        message:
          type: string
    developer.AttributesParam:
      oneOf:
        - type: string
          enum:
            - all
            - primary
            - none
          description: Simple string values for common attribute sets
        - type: object
          properties:
            mode:
              type: string
              enum:
                - custom
              description: Must be 'custom' when using object format
            slugs:
              type: array
              items:
                type: string
              description: Array of attribute slugs to include
              minItems: 1
          required:
            - mode
            - slugs
          description: Object format for custom attribute selection
      description: >-
        Attributes parameter supports both string values ('all', 'primary',
        'none') and object format for custom selection
    developer.SortParam:
      type: object
      properties:
        attribute:
          description: attribute slug or ID
          type: string
        direction:
          description: '"asc" or "desc"'
          type: string
    developer.RecordResponse:
      type: object
      properties:
        attributes:
          type: object
          additionalProperties: {}
        created_at:
          type: string
        id:
          type: string
        object_id:
          type: string
        type:
          type: string
        updated_at:
          type: string
        workspace_id:
          type: string
      example:
        id: '32414268188027655'
        object_id: '32414268188027650'
        type: person
        workspace_id: '32414268188027645'
        created_at: '2024-01-15T14:20:00Z'
        updated_at: '2024-01-20T09:15:00Z'
        attributes:
          name:
            first_name: Alice
            last_name: Johnson
          email_addresses:
            - alice@techcorp.com
          job_title: Product Manager
          phone_number:
            country_code: 1
            number: '5551112222'
          location:
            street: 456 Innovation Dr
            city: Austin
            region: TX
            postal_code: '73301'
            country: US
          linkedin:
            username: alicejohnson
            url: https://linkedin.com/in/alicejohnson
  securitySchemes:
    ApiKeyAuth:
      description: 'API key for authentication (format: "Bearer YOUR_API_KEY")'
      type: apiKey
      name: Authorization
      in: header

````