# Introduction
Source: https://docs.meerapi.com/api-reference/introduction

This is the API reference for Meer API - check out the endpoints for more information on how to query each endpoint.
All endpoints require an API key in the Authorization Header



# Check phone number against DNC registry
Source: https://docs.meerapi.com/api-reference/phone-numbers/check-phone-number-against-dnc-registry

/api-reference/openapi.json get /check_phone_number
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. `+<country-code> <phone-number>`.

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.



# usage_stats
Source: https://docs.meerapi.com/api-reference/usage-stats



Returns the calling customer's lifetime API usage broken down by month and by country.

Usage is scoped automatically to the customer who owns the API key — there are no body, path, or query parameters that accept a customer identity. A caller can only see usage for the customer their key is bound to.

The response gives you three views of the same underlying data:

* `total_requests` — the canonical lifetime total, computed as the sum of `monthly[].request_count`.

* `monthly` — a per-month breakdown, sorted ascending by `(year, month)`. Months with no recorded usage may be omitted.

* `by_country` — a flat per-country breakdown across all time, sorted by `request_count` descending then `country` ascending.

**Rate Limiting:** This endpoint does **not** consume your monthly request quota — viewing your own usage is free.

**Country codes** in `by_country` are ISO 3166-1 alpha-2 (e.g., `US`, `GB`, `IE`)

## Headers

<ParamField type="string">
  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`
</ParamField>

## Response

<ResponseExample>
  ```text 200 theme={null}
  {
      "customer_name": "www.customer.com",
      "total_requests": 100,
      "monthly": [
          {
              "year": 2026,
              "month": 2,
              "request_count": 100
          },
          {
              "year": 2026,
              "month": 3,
              "request_count": 200
          },
          {
              "year": 2026,
              "month": 4,
              "request_count": 300
          },
          {
              "year": 2026,
              "month": 5,
              "request_count": 400
          }
      ],
      "by_country": [
          {
              "country": "GB",
              "request_count": 700
          },
          {
              "country": "US",
              "request_count": 200
          },
          {
              "country": "FR",
              "request_count": 100
          }
      ]
  }
  ```

  ```text 401 theme={null}
  Unauthorized - missing API key
  ```

  ```text 403 theme={null}
  Forbidden - invalid API keyForbidden - invalid API key
  ```

  ```text 500 theme={null}
  Internal Server Error
  ```
</ResponseExample>

<ResponseField name="customer_name" type="string">
  The name of your customer account
</ResponseField>

<ResponseField name="total_requests" type="int">
  The total number of requests you have made to our API
</ResponseField>

<ResponseField name="monthly" type="object">
  An aggregation of the details of your requests by year, mount, and request count

  ```text theme={null}
  "monthly": [
          {
              "year": 2026,
              "month": 2,
              "request_count": 583
          },
          {
              "year": 2026,
              "month": 3,
              "request_count": 14542
          }
  ]
  ```
</ResponseField>

<ResponseField name="by_country" type="object">
  A list of all requests made by country

  ```text theme={null}
  "by_country": [
          {
              "country": "GB",
              "request_count": 32895
          }
  ]
  ```
</ResponseField>


# Consuming the API
Source: https://docs.meerapi.com/guides/quickstart

Working with Meer API is a simple two-step process.

### Step 1: Sign up for an API Key

Request a key at [the Meer API official website](https://www.meerapi.com/) - this process will soon be automated.

### Step 2: Start querying

Use your token to query our HTTPS APIs - namely we can check if a phone number is on a Do Not Call list as per below. We just need:

* The phone number we want to check
* An API token

<RequestExample>
  ```filename theme={null}
  curl --request GET \
    --url https://api.meerapi.com/check_phone_number?phone_number=<url-encoded-phone-number> \
    --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

Follow the link below for full documentation and examples

<CardGroup>
  <Card title="API Documentation" icon="code" href="/api-reference/introduction" />
</CardGroup>