> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# buy_return_status

> Status + return-label URLs for a return started with buy_return_order (by its return_id).

Connect to `https://mcp.agentcard.sh/mcp` with the **user's connection token** (or a `buy_token` for org-owned accounts).

**Behavior:** read-only, idempotent.

<Note>Not in the default `tools/list`. It is still callable by exact name, and appears when the client sends the `x-expert-tools: 1` header.</Note>

## What it does

Status + return-label URLs for a return started with buy\_return\_order (by its return\_id). Statuses: open (being processed), approved (labels issued — relay them), denied (see resolution notes), credited (refund issued).

## Inputs

| Field | Type | Description |
| - | - | - |
| `merchant` *(required)* | string | |
| `return_id` *(required)* | string | the return\_id from buy\_return\_order |

## Returns

None.

## Example call

```json theme={null}
{
  "tool": "buy_return_status",
  "arguments": {
    "merchant": "\u2026",
    "return_id": "\u2026"
  }
}
```


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