> For the complete documentation index, see [llms.txt](https://docs.bindpay.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bindpay.xyz/api/successful-transactions.md).

# Successful Transactions

Get a list of all successful transactions - don't hesitate to reach out for additional support at support\@bindpay.xyz

**Endpoint**

```
GET https://api.bindpay.xyz/v1/successful-transactions
```

### Headers

| Header       | Value            | Description                            |
| ------------ | ---------------- | -------------------------------------- |
| Content-Type | application/json | The content type of the request        |
| x-api-key    | Your API key     | Your unique API key for authentication |

### Query Parameters

None required. The API will return all successful transactions associated with your API key.

### Notes

* Returns all completed transactions for your business or specific subpayee
* Transactions are sorted by creation date (newest first)
* Results include both direct transfers and cross-chain swaps
* For subpayee API keys, only transactions related to that specific subpayee are returned

### Example Request

{% code lineNumbers="true" %}

```url
curl -X GET "https://api.bindpay.xyz/v1/successful-transactions" \
     -H "Content-Type: application/json" \
     -H "x-api-key: your_api_key_here"
```

{% endcode %}

### Response

The API will respond with a JSON array containing the transaction details.

#### Successful Response

```json
[
  {
    "id": "6729a49048ad67c3a3611163",
    "fromChain": "1",
    "toChain": "137",
    "fromToken": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "toToken": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
    "fromAmount": "100000000",
    "toAmount": "99750000",
    "usdAmount": 100,
    "fromAddress": "0x742d35Cc6634C0532925a3b844Bc45426438f000",
    "toAddress": "0x123d35Cc6634C0532925a3b844Bc45426438f789",
    "type": "Provider",
    "fee": "250000",
    "createdAt": "2024-03-19T10:30:00.000Z",
    "sourceTransactionHash": "0x123...",
    "destinationTransactionHash": "0x456...",
    "sourceAmount": "100000000",
    "destinationAmount": "99750000"
  }
  // ... additional transactions
]
```

#### Response Fields

| Field                      | Type   | Description                         |
| -------------------------- | ------ | ----------------------------------- |
| id                         | string | Unique transaction identifier       |
| fromChain                  | string | Source blockchain chain ID          |
| toChain                    | string | Destination blockchain chain ID     |
| fromToken                  | string | Source token address                |
| toToken                    | string | Destination token address           |
| fromAmount                 | string | Original amount in token decimals   |
| toAmount                   | string | Received amount in token decimals   |
| usdAmount                  | number | Transaction value in USD            |
| fromAddress                | string | Source wallet address               |
| toAddress                  | string | Destination wallet address          |
| type                       | string | Transaction type (Quote Provider)   |
| fee                        | string | Fee amount in token decimals        |
| createdAt                  | string | Transaction creation timestamp      |
| sourceTransactionHash      | string | Hash of the source transaction      |
| destinationTransactionHash | string | Hash of the destination transaction |
| sourceAmount               | string | Actual sent amount                  |
| destinationAmount          | string | Actual received amount              |

### Status Codes

| Status Code | Error Type            | Description         |
| ----------- | --------------------- | ------------------- |
| 200         | Success               | Request successful  |
| 400         | Bad Request           | API key is missing  |
| 404         | Not Found             | Business not found  |
| 429         | Too Many Requests     | Rate limit exceeded |
| 500         | Internal Server Error | Server error        |

### Error Handling

* Missing API key will return a 400 error
* Invalid API key will return a 404 error
* Rate limit exceeded will return a 429 error
* Server errors will return a 500 error with details

For more information on error handling and response codes, please get in contact with <support@bindpay.xyz>.