# Blackbird API – Retrieve Payment Intent

> Blackbird API – Retrieve Payment Intent is a paid API for AI agents from the-stables-blackbird-api.vercel.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Fetch a single Payment Intent by ID and return its current derived status (e.g. pending, paid, cancelled, refunded).

## Facts

- Endpoint: GET https://the-stables-blackbird-api.vercel.app/api/payment_intents/:id
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blackbird-api-retrieve-payment-intent-7b5c935f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8TzGIakGnl5RdmCcWqgff

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blackbird-api-retrieve-payment-intent-7b5c935f
```

Example prompt: Can you look up Blackbird payment intent pmt_abc123xyz and tell me what its current status is — whether it's still pending, been paid, or something else?

## When to prefer this

Use this endpoint when you need to check or confirm the current status of a specific Blackbird payment intent by ID — for example, to verify a transaction completed, confirm a refund was applied, or audit a payment record. Prefer it over list-style endpoints when you already have the payment intent ID and need authoritative status for a single record.

## Known failure modes

- 404 if the payment intent ID does not exist or belongs to another member
- 401 if no valid Blackbird identity is provided (missing x402 credential or member JWT)
- 400 if the request is malformed
- Payment required (402) on first call without a pre-linked wallet, triggering x402 flow
- Rate limiting or quota errors if called excessively

## How this service works

Retrieve a Payment Intent with its derived status. Requires a Blackbird identity: link your agent wallet once at /connect, then call with x402 + SIWX (first call pays, later SIWX-signed calls are free); or pass a member JWT in the X-Blackbird-Token header.

## Output

Returns a Payment Intent object including its unique ID, derived status (pending, paid, cancelled, or refunded), associated amount, FLY transfer details, and timestamps. The derived status reflects the most current computed state of the payment lifecycle.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blackbird-api-retrieve-payment-intent-7b5c935f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from the-stables-blackbird-api.vercel.app](https://www.zero.xyz/host/the-stables-blackbird-api.vercel.app/llms.txt)