{
  "info": {
    "_postman_id": "26ec166c-3104-41c6-9639-f2811e1dbe3a",
    "name": "SWIFT SwiftRef Account Numbers National IDs API",
    "description": "The SWIFT SwiftRef API provides automated real-time lookup and validation of payments reference data. Supports validation and retrieval of BICs, IBANs, LEIs, National IDs, country codes, currency codes, and account numbers. Enables financial institutions, corporates, and PSPs to achieve greater straight-through processing rates by validating identifiers before payment execution. Data is updated daily from authoritative sources.\n\nContact Support:\n Name: SWIFT Developer Support\n Email: developer-support@swift.com",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "createdAt": "2026-07-28T03:07:21.000Z",
    "updatedAt": "2026-07-28T03:07:22.000Z",
    "lastUpdatedBy": "35240",
    "uid": "35240-26ec166c-3104-41c6-9639-f2811e1dbe3a"
  },
  "item": [
    {
      "name": "v2",
      "item": [
        {
          "name": "national_ids",
          "item": [
            {
              "name": "{national_id}",
              "item": [
                {
                  "name": "validity",
                  "item": [
                    {
                      "name": "Validate National ID",
                      "id": "6f5a840c-ae0c-4db7-ac7c-10918770bccf",
                      "protocolProfileBehavior": {
                        "disableBodyPruning": true
                      },
                      "request": {
                        "method": "GET",
                        "header": [
                          {
                            "key": "Accept",
                            "value": "application/json"
                          }
                        ],
                        "url": {
                          "raw": "{{baseUrl}}/v2/national_ids/:national_id/validity",
                          "host": [
                            "{{baseUrl}}"
                          ],
                          "path": [
                            "v2",
                            "national_ids",
                            ":national_id",
                            "validity"
                          ],
                          "variable": [
                            {
                              "id": "5e84969a-dc4e-40dd-9a22-2f91d3187e6d",
                              "key": "national_id",
                              "value": "<string>",
                              "description": "(Required) National ID clearing code or routing number"
                            }
                          ]
                        },
                        "description": "Checks the validity of a National ID (clearing code or routing number)."
                      },
                      "response": [
                        {
                          "id": "d14c4be1-e521-4994-ac38-c2193f3fabee",
                          "name": "National ID validity result",
                          "originalRequest": {
                            "method": "GET",
                            "header": [
                              {
                                "key": "Accept",
                                "value": "application/json"
                              },
                              {
                                "description": "Added as a part of security scheme: oauth2",
                                "key": "Authorization",
                                "value": "<token>"
                              }
                            ],
                            "url": {
                              "raw": "{{baseUrl}}/v2/national_ids/:national_id/validity",
                              "host": [
                                "{{baseUrl}}"
                              ],
                              "path": [
                                "v2",
                                "national_ids",
                                ":national_id",
                                "validity"
                              ],
                              "variable": [
                                {
                                  "key": "national_id"
                                }
                              ]
                            }
                          },
                          "status": "OK",
                          "code": 200,
                          "_postman_previewlanguage": "json",
                          "header": [
                            {
                              "key": "Content-Type",
                              "value": "application/json"
                            }
                          ],
                          "cookie": [],
                          "responseTime": null,
                          "body": "{\n  \"valid\": \"<boolean>\",\n  \"errorCode\": \"<string>\",\n  \"errorDescription\": \"<string>\"\n}",
                          "createdAt": "2026-07-28T03:07:22.000Z",
                          "updatedAt": "2026-07-28T03:07:22.000Z",
                          "uid": "35240-d14c4be1-e521-4994-ac38-c2193f3fabee"
                        }
                      ],
                      "createdAt": "2026-07-28T03:07:22.000Z",
                      "updatedAt": "2026-07-28T03:07:22.000Z",
                      "uid": "35240-6f5a840c-ae0c-4db7-ac7c-10918770bccf"
                    }
                  ],
                  "id": "156df2f4-eea8-46d7-ab0c-4a6d30f3ab0c",
                  "createdAt": "2026-07-28T03:07:22.000Z",
                  "updatedAt": "2026-07-28T03:07:22.000Z",
                  "uid": "35240-156df2f4-eea8-46d7-ab0c-4a6d30f3ab0c"
                },
                {
                  "name": "bics",
                  "item": [
                    {
                      "name": "Get BICs for National ID",
                      "id": "962698f0-33a4-424f-9512-15cb144187d4",
                      "protocolProfileBehavior": {
                        "disableBodyPruning": true
                      },
                      "request": {
                        "method": "GET",
                        "header": [
                          {
                            "key": "Accept",
                            "value": "application/json"
                          }
                        ],
                        "url": {
                          "raw": "{{baseUrl}}/v2/national_ids/:national_id/bics",
                          "host": [
                            "{{baseUrl}}"
                          ],
                          "path": [
                            "v2",
                            "national_ids",
                            ":national_id",
                            "bics"
                          ],
                          "variable": [
                            {
                              "id": "4bf11d36-7e0f-4dce-b641-89b798e0f11b",
                              "key": "national_id",
                              "value": "<string>",
                              "description": "(Required) National ID clearing code or routing number"
                            }
                          ]
                        },
                        "description": "Returns the BIC(s) associated with a National ID."
                      },
                      "response": [
                        {
                          "id": "1965ecce-7bff-43b2-b961-304eff94e329",
                          "name": "BICs for the National ID",
                          "originalRequest": {
                            "method": "GET",
                            "header": [
                              {
                                "key": "Accept",
                                "value": "application/json"
                              },
                              {
                                "description": "Added as a part of security scheme: oauth2",
                                "key": "Authorization",
                                "value": "<token>"
                              }
                            ],
                            "url": {
                              "raw": "{{baseUrl}}/v2/national_ids/:national_id/bics",
                              "host": [
                                "{{baseUrl}}"
                              ],
                              "path": [
                                "v2",
                                "national_ids",
                                ":national_id",
                                "bics"
                              ],
                              "variable": [
                                {
                                  "key": "national_id"
                                }
                              ]
                            }
                          },
                          "status": "OK",
                          "code": 200,
                          "_postman_previewlanguage": "json",
                          "header": [
                            {
                              "key": "Content-Type",
                              "value": "application/json"
                            }
                          ],
                          "cookie": [],
                          "responseTime": null,
                          "body": "[\n  {\n    \"bic\": \"<string>\",\n    \"institutionName\": \"<string>\",\n    \"countryCode\": \"<string>\",\n    \"city\": \"<string>\",\n    \"address\": \"<string>\",\n    \"status\": \"<string>\",\n    \"connectedToBIC\": \"<boolean>\"\n  },\n  {\n    \"bic\": \"<string>\",\n    \"institutionName\": \"<string>\",\n    \"countryCode\": \"<string>\",\n    \"city\": \"<string>\",\n    \"address\": \"<string>\",\n    \"status\": \"<string>\",\n    \"connectedToBIC\": \"<boolean>\"\n  }\n]",
                          "createdAt": "2026-07-28T03:07:22.000Z",
                          "updatedAt": "2026-07-28T03:07:22.000Z",
                          "uid": "35240-1965ecce-7bff-43b2-b961-304eff94e329"
                        }
                      ],
                      "createdAt": "2026-07-28T03:07:22.000Z",
                      "updatedAt": "2026-07-28T03:07:22.000Z",
                      "uid": "35240-962698f0-33a4-424f-9512-15cb144187d4"
                    }
                  ],
                  "id": "9bb146ef-aef8-437c-a5d3-3641ef3b56dc",
                  "createdAt": "2026-07-28T03:07:22.000Z",
                  "updatedAt": "2026-07-28T03:07:22.000Z",
                  "uid": "35240-9bb146ef-aef8-437c-a5d3-3641ef3b56dc"
                },
                {
                  "name": "Get National ID Details",
                  "id": "8e5073b1-d844-4e1b-992f-888a53025c82",
                  "protocolProfileBehavior": {
                    "disableBodyPruning": true
                  },
                  "request": {
                    "method": "GET",
                    "header": [
                      {
                        "key": "Accept",
                        "value": "application/json"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/v2/national_ids/:national_id",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v2",
                        "national_ids",
                        ":national_id"
                      ],
                      "variable": [
                        {
                          "id": "ccfbec95-8b31-4aaf-819e-1ca1e6d36c77",
                          "key": "national_id",
                          "value": "<string>",
                          "description": "(Required) National ID clearing code or routing number"
                        }
                      ]
                    },
                    "description": "Returns details for a National ID (clearing code, routing number) used for domestic payment routing."
                  },
                  "response": [
                    {
                      "id": "c2c6f657-572c-4f49-ba7b-ac22d5b45155",
                      "name": "National ID details",
                      "originalRequest": {
                        "method": "GET",
                        "header": [
                          {
                            "key": "Accept",
                            "value": "application/json"
                          },
                          {
                            "description": "Added as a part of security scheme: oauth2",
                            "key": "Authorization",
                            "value": "<token>"
                          }
                        ],
                        "url": {
                          "raw": "{{baseUrl}}/v2/national_ids/:national_id",
                          "host": [
                            "{{baseUrl}}"
                          ],
                          "path": [
                            "v2",
                            "national_ids",
                            ":national_id"
                          ],
                          "variable": [
                            {
                              "key": "national_id"
                            }
                          ]
                        }
                      },
                      "status": "OK",
                      "code": 200,
                      "_postman_previewlanguage": "json",
                      "header": [
                        {
                          "key": "Content-Type",
                          "value": "application/json"
                        }
                      ],
                      "cookie": [],
                      "responseTime": null,
                      "body": "{\n  \"nationalId\": \"<string>\",\n  \"type\": \"<string>\",\n  \"bankName\": \"<string>\",\n  \"countryCode\": \"<string>\",\n  \"city\": \"<string>\"\n}",
                      "createdAt": "2026-07-28T03:07:22.000Z",
                      "updatedAt": "2026-07-28T03:07:22.000Z",
                      "uid": "35240-c2c6f657-572c-4f49-ba7b-ac22d5b45155"
                    },
                    {
                      "id": "8e389fb1-239e-4161-9485-1ca94996c9d1",
                      "name": "Identifier not found in reference data",
                      "originalRequest": {
                        "method": "GET",
                        "header": [
                          {
                            "key": "Accept",
                            "value": "application/json"
                          },
                          {
                            "description": "Added as a part of security scheme: oauth2",
                            "key": "Authorization",
                            "value": "<token>"
                          }
                        ],
                        "url": {
                          "raw": "{{baseUrl}}/v2/national_ids/:national_id",
                          "host": [
                            "{{baseUrl}}"
                          ],
                          "path": [
                            "v2",
                            "national_ids",
                            ":national_id"
                          ],
                          "variable": [
                            {
                              "key": "national_id"
                            }
                          ]
                        }
                      },
                      "status": "Not Found",
                      "code": 404,
                      "_postman_previewlanguage": "json",
                      "header": [
                        {
                          "key": "Content-Type",
                          "value": "application/json"
                        }
                      ],
                      "cookie": [],
                      "responseTime": null,
                      "body": "{\n  \"code\": \"<string>\",\n  \"message\": \"<string>\"\n}",
                      "createdAt": "2026-07-28T03:07:22.000Z",
                      "updatedAt": "2026-07-28T03:07:22.000Z",
                      "uid": "35240-8e389fb1-239e-4161-9485-1ca94996c9d1"
                    }
                  ],
                  "createdAt": "2026-07-28T03:07:22.000Z",
                  "updatedAt": "2026-07-28T03:07:22.000Z",
                  "uid": "35240-8e5073b1-d844-4e1b-992f-888a53025c82"
                }
              ],
              "id": "2a293cba-a848-46d6-99c0-aae89e74e773",
              "createdAt": "2026-07-28T03:07:22.000Z",
              "updatedAt": "2026-07-28T03:07:22.000Z",
              "uid": "35240-2a293cba-a848-46d6-99c0-aae89e74e773"
            }
          ],
          "id": "25c81d05-8c56-4fdc-8931-473ec6100cee",
          "createdAt": "2026-07-28T03:07:22.000Z",
          "updatedAt": "2026-07-28T03:07:22.000Z",
          "uid": "35240-25c81d05-8c56-4fdc-8931-473ec6100cee"
        }
      ],
      "id": "901bef53-f058-4928-af84-e03fe3e1dc26",
      "createdAt": "2026-07-28T03:07:22.000Z",
      "updatedAt": "2026-07-28T03:07:22.000Z",
      "uid": "35240-901bef53-f058-4928-af84-e03fe3e1dc26"
    }
  ],
  "auth": {
    "type": "oauth2",
    "oauth2": [
      {
        "key": "scope",
        "value": "urn:swiftref:external urn:swiftref:internal",
        "type": "string"
      },
      {
        "key": "accessTokenUrl",
        "value": "https://api.swift.com/oauth2/v1/token",
        "type": "string"
      },
      {
        "key": "grant_type",
        "value": "password_credentials",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.swift.com/swiftrefdata"
    }
  ]
}