---
updatedAt: 2026-09-16T12:23:30.000Z
agentTools:
  projectIndex: https://docs.datanomik.com/llms.txt
---

# List Countries

List all countries

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "openbanking-api",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.datanomik.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/v1/countries": {
      "get": {
        "summary": "List Countries",
        "description": "List all countries",
        "operationId": "v1countries",
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"content\": [\n        {\n            \"iso\": \"AR\",\n            \"name\": \"Argentina\",\n            \"icon\": \"https://resources.datanomik.com/flags/ar.svg\"\n        },\n        {\n            \"iso\": \"BR\",\n            \"name\": \"Brazil\",\n            \"icon\": \"https://resources.datanomik.com/flags/br.svg\"\n        },\n        {\n            \"iso\": \"BO\",\n            \"name\": \"Bolivia\",\n            \"icon\": \"https://resources.datanomik.com/flags/bo.svg\"\n        },\n        {\n            \"iso\": \"CO\",\n            \"name\": \"Colombia\",\n            \"icon\": \"https://resources.datanomik.com/flags/co.svg\"\n        },\n        {\n            \"iso\": \"CH\",\n            \"name\": \"Chile\",\n            \"icon\": \"https://resources.datanomik.com/flags/ch.svg\"\n        },\n        {\n            \"iso\": \"PY\",\n            \"name\": \"Paraguay\",\n            \"icon\": \"https://resources.datanomik.com/flags/py.svg\"\n        },\n        {\n            \"iso\": \"PE\",\n            \"name\": \"Peru\",\n            \"icon\": \"https://resources.datanomik.com/flags/pe.svg\"\n        },\n        {\n            \"iso\": \"UY\",\n            \"name\": \"Uruguay\",\n            \"icon\": \"https://resources.datanomik.com/flags/uy.svg\"\n        }\n    ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "content": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "iso": {
                            "type": "string",
                            "example": "AR"
                          },
                          "name": {
                            "type": "string",
                            "example": "Argentina"
                          },
                          "icon": {
                            "type": "string",
                            "example": "https://resources.datanomik.com/flags/ar.svg"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"code\": 401,\n    \"type\": \"UNAUTHORIZED\",\n    \"message\": \"Invalid credentials\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 401,
                      "default": 0
                    },
                    "type": {
                      "type": "string",
                      "example": "UNAUTHORIZED"
                    },
                    "message": {
                      "type": "string",
                      "example": "Invalid credentials"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Forbidden. Source IP not whitelisted, credentials without the required scope, or trial period expired.",
            "content": {
              "application/json": {
                "examples": {
                  "IP_NOT_ALLOWED": {
                    "value": "{\n    \"code\": 632,\n    \"type\": \"IP_NOT_ALLOWED\",\n    \"message\": \"Source ip address not allowed.\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\"\n}"
                  },
                  "FORBIDDEN": {
                    "value": "{\n    \"code\": 403,\n    \"type\": \"FORBIDDEN\",\n    \"message\": \"Forbidden\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 632
                    },
                    "type": {
                      "type": "string",
                      "example": "IP_NOT_ALLOWED"
                    },
                    "message": {
                      "type": "string",
                      "example": "Source ip address not allowed."
                    },
                    "traceId": {
                      "type": "string",
                      "example": "0af7651916cd43dd8448eb211c80319c"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error. Unexpected error; report the `traceId` to support.",
            "content": {
              "application/json": {
                "examples": {
                  "INTERNAL_ERROR": {
                    "value": "{\n    \"code\": 500,\n    \"type\": \"INTERNAL_ERROR\",\n    \"message\": \"Unexpected error. Please contact support with the traceId.\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 500
                    },
                    "type": {
                      "type": "string",
                      "example": "INTERNAL_ERROR"
                    },
                    "message": {
                      "type": "string",
                      "example": "Unexpected error. Please contact support with the traceId."
                    },
                    "traceId": {
                      "type": "string",
                      "example": "0af7651916cd43dd8448eb211c80319c"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```