Documentation

API URL


GET /api/v1/country-codes/countries

Headers
Code
Content-Type: application/json
Query Parameters


Example GET Request

Code
GET https://datpaq.com/api/v1/country-codes/countries?api_key=your-api-key

Successful Response

Status
HTML
200 OK
Body
Code
{
  "success": true,
  "data": {
    "countryName": "United States of America",
    "iso2": "US",
    "iso3": "USA",
    "numericCode": 840
  },
  "meta": {
    "lookupType": "code",
    "timestamp": "2026-06-09T00:00:00.000Z",
    "correlationId": "req_abc123def456"
  }
}

Error Response

Example
Code
400 ValidationError - Missing q query parameter for search or match endpoint: Request rejected because required search input was not provided
401 AuthenticationError - Gateway authentication failure: Request rejected due to missing or invalid API credentials
404 NotFound - No country resolved for code or match input: Lookup completed with no matching country record
500 InternalError - Database or runtime processing failure: Request failed during internal query or response processing

Last Updated:  May 4, 2026