# Swift Code Get Swift

> List SWIFT records with optional filters and pagination.

- Skill: `gabrielmoreira/swift-code-get-swift` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/swift-code-get-swift`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/swift-code-get-swift/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/swift-code-get-swift

---


## Endpoint

**GET https://requiems.xyz/v1/finance/swift**

## List SWIFT Codes

List SWIFT records with optional filters and pagination.

## Parameters

| Name | Type | Required | Location | Description |
| ---- | ---- | -------- | -------- | ----------- |
| `country_code` | string | no | query | Optional 2-letter country code filter (e.g. DE, US) |
| `bank_code` | string | no | query | Optional 4-letter bank code filter (e.g. DEUT) |
| `q` | string | no | query | Optional text search across swift_code, bank_name, and city |
| `limit` | integer | no | query | Max rows to return (default 50, max 200) |
| `offset` | integer | no | query | Number of rows to skip (default 0) |

## Response Example

```json
{
  "data": {
    "items": [
      {
        "swift_code": "DEUTDEDBXXX",
        "bank_code": "DEUT",
        "country_code": "DE",
        "location_code": "DB",
        "branch_code": "XXX",
        "bank_name": "Deutsche Bank Privat-Und Geschaeftskunden Ag - Head Office",
        "city": "Frankfurt Am Main",
        "country_name": "Germany",
        "is_primary": true
      }
    ],
    "limit": 50,
    "offset": 0,
    "returned": 1
  },
  "metadata": {
    "timestamp": "2026-01-01T00:00:00Z"
  }
}
```

## Errors

- `400` **bad_request** — Invalid filter or pagination parameter.
- `500` **internal_error** — Unexpected server error.