---
title: "List number requests for the account, newest first (paginated)"
method: GET
path: "/v2/number-requests"
tags: ["number-requests-v2"]
---

# List number requests for the account, newest first (paginated)

`GET /v2/number-requests`

## Request

- Base URL: `https://api.tracklysms.com/api`
- URL: `https://api.tracklysms.com/api/v2/number-requests`
- Auth: API key in header `X-Api-Key`

## Query parameters

- `per_page` string
- `page` string

## Response `200`

Paginated public number requests

- NumberRequestListResponse
  - `pagination` NumberRequestPagination, required
    - `page` integer, required
    - `per_page` integer, required
    - `total` integer, required
    - `total_pages` integer, required
  - `requests` PublicNumberRequest[], required
    - `addressCity` string
    - `addressCountry` string
    - `addressPostalCode` string
    - `addressState` string
    - `addressStreet` string
    - `brandName` string
    - `businessContactEmail` string
    - `businessContactFirstName` string
    - `businessContactLastName` string
    - `businessVerification` object: Confirmed business identity, verification state, and readiness.
    - `campaignStage` string
    - `companyLegalName` string
    - `contactEmail` string
    - `contactPhone` string
    - `createdAt` string: ISO-8601 creation time
    - `estimatedMonthlyVolume` string
    - `id` string
    - `identifierType` string: Country-scoped carrier identifier type; the identifier value is never returned
    - `industry` string
    - `internationalAcquisitionDocuments` NumberRequestAcquisitionDocument[]
      - `contentType` string: Validated media type
      - `filename` string: Stored display filename
      - `requirementKey` string: Provider requirement key
      - `size` integer: Stored byte count
      - `uploadedAt` string: ISO-8601 upload time
    - `internationalAcquisitionFeedback` object
    - `internationalAcquisitionFormData` object
    - `internationalAcquisitionStatus` string
    - `listName` string
    - `messagingType` string
    - `optInFormUrl` string
    - `phoneNumberType` string
    - `privacyPolicyUrl` string
    - `provisionedPhoneNumber` string
    - `provisioningStatus` string
    - `rejectionReason` string
    - `status` string
    - `targetCountries` string[]
    - `termsConditionsUrl` string
    - `updatedAt` string: ISO-8601 update time
    - `vertical` string
    - `websiteUrl` string

## Other responses

- `401`: Authentication error

---

[API](https://skmtc.dev/tracklysms/apis/trackly-sms-api.md) · [All operations](https://skmtc.dev/tracklysms/apis/trackly-sms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tracklysms/apis/trackly-sms-api/revisions/ac1ad22cb2a9?raw)