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

# Request access to restricted features via the Meow API

> Request access to restricted Meow API features like international payments, submit the eligibility details, and check the request status.

## Prerequisites

* A Meow account
* An API key with the `feature-access:write` permission to request access, and `feature-access:read` to check status

## Understanding Restricted Features

Some features are turned off until our team reviews your business for them. Instead of failing a call, you request access to the feature and we review the details you send. Today the API exposes one requestable feature:

| Feature                | Value                    |
| ---------------------- | ------------------------ |
| International payments | `international_payments` |

You send the eligibility details for the feature, we notify the team that reviews them, and the request moves through these statuses:

| Status     | Meaning                                 |
| ---------- | --------------------------------------- |
| `pending`  | Awaiting review                         |
| `approved` | The feature is enabled for your account |
| `rejected` | The request was declined                |

Eligible businesses may be approved right away. Requesting a feature you have already requested returns its current status instead of opening a duplicate.

## Requesting Access to International Payments

### Step 1: Prepare Your Eligibility Details

International payments needs an eligibility questionnaire so the team can review your request. Gather:

* Your expected monthly volume and number of payments
* What you will use international payments for
* The destination countries you plan to send to

### Step 2: Request Access

```bash theme={null}
curl -X POST "https://api.meow.com/v1/feature-access/requests" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "feature": "international_payments",
    "eligibility": {
      "monthly_volume": "from_25k_to_100k",
      "monthly_payment_count": "from_11_to_20",
      "purposes": ["supplier_payments"],
      "countries_served": ["GB", "DE", "KE"]
    }
  }'
```

The `eligibility` fields accept these values:

| Field                   | Values                                                                                   |
| ----------------------- | ---------------------------------------------------------------------------------------- |
| `monthly_volume`        | `less_than_10k`, `from_10k_to_25k`, `from_25k_to_100k`, `from_100k_to_500k`, `over_500k` |
| `monthly_payment_count` | `ten_or_fewer`, `from_11_to_20`, `from_21_to_30`, `from_31_to_40`, `over_40`             |
| `purposes`              | Any of `supplier_payments`, `payroll`, `customer_refunds`, `other`                       |
| `other_purpose`         | Free text describing your use when `purposes` includes `other`                           |
| `countries_served`      | One or more destination countries as ISO 3166-1 alpha-2 codes                            |

<Note>
  Include `other` in `purposes` and describe it in `other_purpose` when none of the listed purposes fit. List every country you expect to pay in `countries_served`, since it drives the eligibility review.
</Note>

### Step 3: Review the Response

A successful response returns the feature and where the request stands:

```json theme={null}
{
  "feature": "international_payments",
  "status": "pending"
}
```

If your business is already eligible, `status` comes back as `approved` and the feature is enabled. Otherwise it stays `pending` until the review completes.

## Checking the Status of Your Requests

List your feature access requests to see where each one stands:

```bash theme={null}
curl -X GET "https://api.meow.com/v1/feature-access/requests" \
  -H "x-api-key: YOUR_API_KEY"
```

Example response:

```json theme={null}
{
  "data": [
    {
      "feature": "international_payments",
      "status": "pending"
    }
  ]
}
```

Poll this endpoint until the feature you requested reports `approved`, then start using it.