> ## Documentation Index
> Fetch the complete documentation index at: https://direct-api.reap.global/llms.txt
> Use this file to discover all available pages before exploring further.

# Approvals

> If your business uses Approvals, cards created through the API wait for an approver in the dashboard before they're issued.

If your business has the Approvals feature enabled, card creation doesn't
issue a card right away: it creates an approval request that an approver acts
on in the Business Account dashboard. See [How
do I set up approval workflows for my team?](https://support.reap.global/hc/en-us/articles/13939633575567-How-do-I-set-up-approval-workflows-for-my-team) in the Help Center.

## What card creation returns

```json theme={"system"}
{ "approvalRequestId": "approval_01JZ2Q8A6B4C3D2E1F0G9H8J7K", "status": "pendingApproval" }
```

Store the `approvalRequestId` and the `title` you chose. Approvers approve or
reject in the dashboard; the API doesn't list or act on approval requests.

* **Approved**: the card is created and shows up in
  [List cards](/api-reference/cards/list-cards.md). Find it by the `title` you
  chose: `GET /cards?title=...`.
* **Rejected**: no card is ever created. Check the dashboard for the
  request's rejection status.

No webhook exists for approval outcomes; poll [List
cards](/api-reference/cards/list-cards.md) if you need to track them.

## Planning for approvals

* Approvals apply per request, so a batch of cards creates a batch of
  approval requests. Have an approver available when you run one.
* Anything approvers should see (why the card exists, who it's for) goes in
  the `message` field of [Create card](/api-reference/cards/create-card.md).

## Related endpoints

* [Create card](/api-reference/cards/create-card.md) ·
  [List cards](/api-reference/cards/list-cards.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.