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

# List DNC Numbers

> Lists the phone numbers on your organization's Do Not Contact (DNC) list, one page at a time, ordered by phone number. Returns 400 if `limit` is not a positive integer or `nextToken` is invalid.



## OpenAPI

````yaml get /dnc
openapi: 3.0.1
info:
  title: AttentPublicAPI
  version: '2024-05-17T21:09:13Z'
servers:
  - url: https://api.attent.app/v1
security: []
paths:
  /dnc:
    get:
      description: >-
        Lists the phone numbers on your organization's Do Not Contact (DNC)
        list, one page at a time, ordered by phone number. Returns 400 if
        `limit` is not a positive integer or `nextToken` is invalid.
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 1000
            default: 100
          description: >-
            Maximum number of phone numbers to return per page. Defaults to 100;
            values above 1000 return 1000.
        - name: nextToken
          in: query
          required: false
          schema:
            type: string
          description: >-
            Opaque cursor returned by a prior response. Pass it back to fetch
            the next page.
      responses:
        '200':
          description: A page of phone numbers on the DNC list
          content:
            application/json:
              schema:
                type: object
                properties:
                  numbers:
                    type: array
                    items:
                      type: object
                      properties:
                        phone:
                          type: string
                          description: The phone number on the DNC list
                        createdAt:
                          type: string
                          format: date-time
                          description: >-
                            The date and time when the phone number was added to
                            the DNC list
                  nextToken:
                    type: string
                    nullable: true
                    description: >-
                      Cursor for the next page. `null` if there are no more
                      results.
              example:
                numbers:
                  - phone: '+15555555555'
                    createdAt: '2026-09-10T18:22:41Z'
                  - phone: '+15555555556'
                    createdAt: '2026-09-12T14:03:09Z'
                nextToken: null
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '500':
          $ref: '#/components/responses/500'
      security:
        - api_key: []
components:
  responses:
    '400':
      description: Bad Request
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
            example:
              message: 'Invalid format for field: phone'
    '401':
      description: Unauthorized - Invalid or missing API key
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
            example:
              message: Unauthorized
    '403':
      description: Forbidden API key
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
            example:
              message: Forbidden
    '500':
      description: Internal Server Error
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
            example:
              message: Internal Server Error
  securitySchemes:
    api_key:
      type: apiKey
      name: x-api-key
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.