---
title: "Request access to a restricted feature"
method: POST
path: "/feature-access/requests"
tags: ["Feature Access"]
---

# Request access to a restricted feature

`POST /feature-access/requests`

## Request

- Base URL: `https://api.meow.com/v1`
- URL: `https://api.meow.com/v1/feature-access/requests`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/meow/apis/meow-api/docs/feature-access/requests/post.ts> (a function with typed inputs; its response is checked against the schema)

Requests access to a restricted feature, such as international payments. Send the eligibility details for the feature and we notify the team that reviews them. Eligible businesses may be approved right away. If you have already requested this feature, we return its current status.

## Headers

- `x-entity-id` string, uuid

## Request body

- RequestFeatureAccessRequest
  - `feature` 'international_payments', required
  - `eligibility` InternationalPaymentsEligibility, required
    - `monthly_volume` 'less_than_10k' | 'from_10k_to_25k' | 'from_25k_to_100k' | 'from_100k_to_500k' | 'over_500k', required
    - `monthly_payment_count` 'ten_or_fewer' | 'from_11_to_20' | 'from_21_to_30' | 'from_31_to_40' | 'over_40', required
    - `purposes` InternationalPaymentPurpose[], nullable: What you will use international payments for. Include `other` and describe it in `other_purpose` if none of the listed purposes fit.
    - `other_purpose` string, nullable: Describe your use of international payments when `purposes` includes `other`.
    - `countries_served` string[], required: The destination countries you plan to send to, as ISO 3166-1 alpha-2 codes. This drives the eligibility review, so list every country you expect to pay.

## Response `200`

Successful Response

- PublicFeatureAccessRequestResponse
  - `feature` 'international_payments', required
  - `status` 'pending' | 'approved' | 'rejected', required

## Other responses

- `400`: The request could not be processed.
- `401`: Authentication failed.
- `403`: The API key is not authorized for this operation, or the user of a global API key is an admin or controller without approved KYC. The KYC case returns the message `KYC is required for controllers and admins.` until that user completes KYC in the Meow dashboard.
- `429`: Too many requests.

---

[API](https://skmtc.dev/meow/apis/meow-api.md) - [All operations](https://skmtc.dev/meow/apis/meow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/meow/apis/meow-api/revisions/ea2d7e25b63b?raw)