---
title: "List all requirements"
method: GET
path: "/requirements"
tags: ["Requirements"]
---

# List all requirements

`GET /requirements`

List all requirements with filtering, sorting, and pagination

## Query parameters

- `filter` object
  - `country_code` string — Filters results to those applying to a 2-character (ISO 3166-1 alpha-2) country code
  - `phone_number_type` 'local' | 'national' | 'toll_free' — Filters results to those applying to a specific phone_number_type
  - `action` 'branded_calling' | 'ordering' | 'porting' — Filters requirements to those applying to a specific action.
- `sort` string[] — Specifies the sort order for results. If you want to sort by a field in ascending order, include it as a sort parameter. If you want to sort in descending order, prepend a `-` in front of the field name.
- `page[number]` integer
- `page[size]` integer

## Response `200`

Successful response

- object
  - `data` DocReqsRequirement[]
    - `record_type` string — Identifies the type of the resource.
    - `country_code` string — The 2-character (ISO 3166-1 alpha-2) country code where this requirement applies
    - `locality` string — The locality where this requirement applies
    - `phone_number_type` 'local' | 'national' | 'toll_free' — Indicates the phone_number_type this requirement applies to. Leave blank if this requirement applies to all number_types.
    - `action` 'both' | 'branded_calling' | 'ordering' | 'porting' — Indicates whether this requirement applies to branded_calling, ordering, porting, or both ordering and porting
    - `requirements_types` DocReqsRequirementType[] — Lists the requirement types necessary to fulfill this requirement
      - `acceptance_criteria` object — Specifies objective criteria for acceptance
        - `time_limit` string — Specifies time-based acceptance criteria
        - `locality_limit` string — Specifies geography-based acceptance criteria
        - `acceptable_values` string[] — Specifies the list of strictly possible values for the requirement. Ignored when empty
        - `max_length` integer — Maximum length allowed for the value
        - `min_length` integer — Minimum length allowed for the value
        - `acceptable_characters` string — Specifies the allowed characters as a string
      - `description` string — Describes the requirement type
      - `example` string — Provides one or more examples of acceptable documents
      - `type` 'document' | 'address' | 'textual' — Defines the type of this requirement type
      - `name` string — A short descriptive name for this requirement_type
      - `record_type` string — Identifies the type of the resource
      - `id` string, uuid — Identifies the associated document
      - `created_at` string — ISO 8601 formatted date-time indicating when the resource was created.
      - `updated_at` string — ISO 8601 formatted date-time indicating when the resource was last updated.
    - `id` string, uuid — Identifies the associated document
    - `created_at` string — ISO 8601 formatted date-time indicating when the resource was created.
    - `updated_at` string — ISO 8601 formatted date-time indicating when the resource was last updated.
  - `meta` PaginationMeta
    - `total_pages` integer, required
    - `total_results` integer
    - `page_number` integer, required
    - `page_size` integer

## Other responses

- `422` — Unprocessable entity. Check the 'detail' field in response for details.
- `default` — Unexpected error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api/revisions/e32d46c5945b/schema)