---
title: "Request a capability"
method: POST
path: "/v1/accounts/{account_id}/capability_requests"
tags: ["CapabilityRequests"]
---

# Request a capability

`POST /v1/accounts/{account_id}/capability_requests`

Submits a request to enable a specific capability for an account. Use this endpoint to request additional features or services for an account.

## Path parameters

- `account_id` string, uuid, required

## Headers

- `request-id` string
- `correlation-id` string
- `idempotency-key` string

## Request body

- RequestCapabilityV1Request
  - `charges` ChargesV1
    - `enable` boolean, required — Determines whether `charges` are enabled for the account.
    - `max_amount` number, double, required — The maximum amount of a single charge.
    - `daily_amount` number, double, required — The maximum dollar amount of charges in a calendar day.
    - `monthly_count` integer, required — The maximum number of charges in a calendar month.
    - `monthly_amount` number, double, required — The maximum dollar amount of charges in a calendar month.
  - `payouts` PayoutsV1
    - `enable` boolean, required — Determines whether `payouts` are enabled for the account.
    - `max_amount` number, double, required — The maximum amount of a single payout.
    - `daily_amount` number, double, required — The maximum dollar amount of payouts in a day.
    - `monthly_count` integer, required — The maximum number of payouts in a month.
    - `monthly_amount` number, double, required — The maximum dollar amount of payouts in a month.
  - `internet` InternetV1
    - `enable` boolean, required
  - `individuals` IndividualsV1
    - `enable` boolean, required
  - `businesses` BusinessesV1
    - `enable` boolean, required
  - `signed_agreement` SignedAgreementV1
    - `enable` boolean, required

## Response `201`

Created

- PagedResponseOfCapabilityRequestV1
  - `meta` PagedResponseMetadata, required — Metadata about the API request, including an identifier, timestamp, and pagination details.
    - `api_request_id` string, uuid, required — Unique identifier for this API request, useful for troubleshooting.
    - `api_request_timestamp` string, date-time, required — Timestamp for this API request, useful for troubleshooting.
    - `total_items` integer, required — Total number of items returned in this response.
    - `page_number` integer, required — Page number for paginated results.
    - `page_size` integer, required — Number of items per page in this response.
    - `max_page_size` integer, required — Maximum allowed page size for this endpoint.
    - `sort_by` string, required — The field that the results were sorted by.
    - `sort_order` 'asc' | 'desc', required
    - `total_pages` integer, required — The number of pages available.
  - `response_type` 'object' | 'array' | 'error' | 'none', required — Indicates the structure of the returned content. - "object" means the `data` field contains a single JSON object. - "array" means the `data` field contains an array of objects. - "error" means the `data` field contains an error object with details of the issue. - "none" means no data is returned.
  - `data` CapabilityRequestV1[], required
    - `id` string, uuid, required — Unique identifier for the capability request.
    - `account_id` string, uuid, required — The unique identifier of the account associated with this capability request.
    - `type` 'charges' | 'payouts' | 'individuals' | 'businesses' | 'signed_agreement' | 'internet', required — The specific type of capability being requested within the category.
    - `category` 'payment_type' | 'customer_type' | 'consent_type', required — The category of the requested capability. Use `payment_type` for charges and payouts, `customer_type` to define `individuals` or `businesses`, and `consent_type` for `signed_agreement` or `internet` payment authorization.
    - `settings` object, nullable — Any specific settings or configurations related to the requested capability.
    - `status` 'active' | 'inactive' | 'in_review' | 'rejected' | 'approved' | 'reviewing', required — The current status of the capability request.
    - `created_at` string, date-time, required — Timestamp of when the capability request was created.
    - `updated_at` string, date-time, required — Timestamp of the most recent update to the capability request.
    - `enable` boolean, required — Whether this capability request is to enable or disable the capability.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Validation Failed
- `500` — Server Error

---

[API](https://skmtc.net/straddleio/apis/straddle-api.md) · [All operations](https://skmtc.net/straddleio/apis/straddle-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/straddleio/straddle-api/versions/6e13cd88cda9/schema)