> ## Documentation Index > Fetch the complete documentation index at: https://docs.meerapi.com/llms.txt > Use this file to discover all available pages before exploring further. # Check phone number against DNC registry > Validates a phone number and checks if it appears in any Do Not Call registries. Returns DNC status and source information if found. Note: Phone numbers should follow the E.164 format for best results - i.e. `+ `. For countries like the USA or Canada there isn't much difference between dialing locally or internationally, i.e. `+1 (678) 123-4567` versus `(678) 123-4567`. For countries like the United Kingdom however, there's a bigger difference between local and international format, i.e. `01000822380` would become `+44 1000822380` - notice we drop the leading 0. We will still try our best to match your number to our database, but know that this has limitations. **Rate Limiting:** This endpoint counts against your monthly request limit. **Resellers:** If you are a reseller, you **must** provide the `X-Forwarded-Host` header containing the domain name of the customer on whose behalf this request is being made. ## OpenAPI ````yaml /api-reference/openapi.json get /check_phone_number openapi: 3.1.0 info: title: Meer API description: >- API for checking phone numbers against Do Not Call (DNC) registries. ## Authentication All endpoints require API key authentication via the `Authorization` header. ## Rate Limiting Requests are limited on a monthly basis per customer. Rate limit information is provided in response headers. ## Reseller Usage If you are a **reseller** integrating the Meer API on behalf of your customers, you **must** include the `X-Forwarded-Host` header on every request. This header identifies the domain of the end customer consuming the API and is required for proper attribution, rate limiting, and compliance tracking. Requests from resellers that omit this header may be rejected. version: 1.1.0 contact: name: API Support servers: - url: https://api.meerapi.com description: Production security: - bearerAuth: [] tags: - name: Phone Numbers description: Phone number validation and DNC checking - name: Usage description: Customer usage analytics paths: /check_phone_number: get: tags: - Phone Numbers summary: Check phone number against DNC registry description: >- Validates a phone number and checks if it appears in any Do Not Call registries. Returns DNC status and source information if found. Note: Phone numbers should follow the E.164 format for best results - i.e. `+ `. For countries like the USA or Canada there isn't much difference between dialing locally or internationally, i.e. `+1 (678) 123-4567` versus `(678) 123-4567`. For countries like the United Kingdom however, there's a bigger difference between local and international format, i.e. `01000822380` would become `+44 1000822380` - notice we drop the leading 0. We will still try our best to match your number to our database, but know that this has limitations. **Rate Limiting:** This endpoint counts against your monthly request limit. **Resellers:** If you are a reseller, you **must** provide the `X-Forwarded-Host` header containing the domain name of the customer on whose behalf this request is being made. operationId: checkPhoneNumber parameters: - name: phone_number in: query required: true description: Phone number to check (e.164 format recommended, e.g., +1234567890) schema: type: string examples: us_number: value: '+14155552671' summary: US phone number international: value: '+442071234567' summary: UK phone number without_plus: value: '14155552671' summary: Number without plus sign - name: X-Forwarded-Host in: header required: false description: >- The domain name of the end customer consuming the API. **Required for resellers** — if you are integrating the Meer API on behalf of customers, you must set this header to the customer's domain (e.g., `customer.example.com`) on every request. This is used for per-customer attribution, rate limiting, and compliance tracking. Direct (non-reseller) API consumers may omit this header. schema: type: string examples: reseller_customer: value: customer.example.com summary: Customer domain for a reseller request responses: '200': description: Successfully checked phone number headers: X-RateLimit-Limit: description: Maximum number of requests allowed per month schema: type: integer example: 10000 X-RateLimit-Remaining: description: Number of requests remaining in current month schema: type: integer example: 9847 content: application/json: schema: $ref: '#/components/schemas/PhoneNumberResponse' example: do_not_call: false timestamp: '2025-12-16T14:32:10.123456789Z' dnc_list_source: null examples: found_in_dnc: summary: Phone number found in DNC registry value: do_not_call: true timestamp: '2025-12-16T14:32:10.123456789Z' dnc_list_source: https://us.gov not_in_dnc: summary: Phone number not in DNC registry value: do_not_call: false timestamp: '2025-12-16T14:32:10.123456789Z' dnc_list_source: null '400': description: Bad request - invalid or missing phone number content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Missing phone_number parameter examples: missing_parameter: summary: Missing phone_number parameter value: error: Missing phone_number parameter malformed_number: summary: Malformed phone number value: error: >- phone number is malformed - please double check the format and try again '401': description: Unauthorized - missing API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: >- Missing API key. Please provide it as: Authorization: Bearer examples: missing_auth: summary: No Authorization header provided value: error: >- Missing API key. Please provide it as: Authorization: Bearer '403': description: Forbidden - invalid API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: invalid API key examples: invalid_key: summary: API key is invalid or inactive value: error: invalid API key '429': description: Rate limit exceeded headers: X-RateLimit-Limit: description: Maximum number of requests allowed per month schema: type: integer example: 10000 X-RateLimit-Remaining: description: Number of requests remaining (will be 0) schema: type: integer example: 0 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: >- Rate limit exceeded. Please try again next month or contact support. examples: limit_exceeded: summary: Monthly request limit reached value: error: >- Rate limit exceeded. Please try again next month or contact support. '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Internal server error examples: auth_error: summary: Internal server error value: error: Internal server error processing_error: summary: Unable to process request value: error: unable to process request database_error: summary: Internal server error during query value: error: Internal server error usage_update_error: summary: Failed to update usage statistics value: error: Failed to update usage statistics components: schemas: PhoneNumberResponse: type: object required: - do_not_call - timestamp properties: do_not_call: type: boolean description: Whether the phone number is on a Do Not Call list example: true timestamp: type: string format: date-time description: RFC3339 timestamp of when the check was performed example: '2025-12-16T14:32:10.123456789Z' dnc_list_source: type: string nullable: true description: The source of the DNC listing (null if not on any list) example: National Do Not Call Registry ErrorResponse: type: object required: - error properties: error: type: string description: Human-readable error message example: Invalid API key securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API-KEY description: >- API key authentication. Provide your API key in the Authorization header: `Authorization: Bearer YOUR_API_KEY` You can also omit the "Bearer" prefix: `Authorization: YOUR_API_KEY` ````