---
title: "Simulate Card Authorization Capture"
method: POST
path: "/simulations/card_authorizations/{authorization_id}/capture"
tags: ["Simulations"]
---

# Simulate Card Authorization Capture

`POST /simulations/card_authorizations/{authorization_id}/capture`

## Request

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

> ⚠️ **Sandbox & development only.** Simulation endpoints are not available in production and return `404 Not Found` there.

Simulates capturing a previously simulated card authorization in the sandbox. Pass the `authorization_id` returned when you created the authorization.

## Path parameters

- `authorization_id` string, required: The simulated authorization, as returned by Simulate Card Authorization.

## Headers

- `x-entity-id` string, uuid

## Request body

- SimulateCardCaptureRequest
  - `capture_amount` union: Amount to capture, in dollars. Defaults to the full authorized amount.
    - number
    - string
  - `close_authorization` boolean, nullable: Whether to close the authorization after capturing.

## Response `200`

Successful Response

- SimulateCardAuthorizationResponse
  - `authorization_id` string, required: The authorization identifier. Pass this to capture, increment, or reverse the authorization.
  - `status` 'pending' | 'closed' | 'expired' | 'reversed', required
  - `amount` string, required: The authorization amount, in dollars.
  - `approved` boolean, required: Whether the authorization was approved.
  - `created_at` string, date-time, required: ISO 8601 date-time in the format `YYYY-MM-DDThh:mm:ss.nnn[Z|[+|-]hh:mm]` (per [IETF RFC 3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)).

## 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)