Skip to main content

Get Countries

API operation: Open the endpoint in Scalar

Use GET /countries to list countries for the current project. The operation is Country.findAll.

This list can be available without operation-level authentication. It supports pagination, ordering, filtering, and the params relationships cities, metafields, and metadata. When params is omitted, those expansions may be included by default; request only what the client needs.

Legacy SDK example​

const response = await ordering.countries().get()

The SDK helper shown here may differ by version.

OpenAPI reference​

Operation: GET /countries

Query parameters

NameTypeRequiredDescription
paramsstringNoComma-separated list of fields. It is intersected with the model’s $fillable; an empty or invalid list returns all fields.
orderBystringNoField to sort by, with - prefixed for descending order. Multiple fields can be chained with commas.
wherestringNoJSON filter over the fields the model declares as filterable. Valid fields for each resource are exposed in its x-ordering-whereable schema extension.
pageintegerNoPage number, starting at 1. Applies only to lists that return a pagination block.
page_sizeintegerNoNumber of items per page.

Responses

CodeDescription
200OK (Envelope)
400Bad Request (ErrorResponse)
401Unauthorized (ProjectAccessErrorResponse)
404Not Found
429Too Many Requests (ErrorResponse)
500Internal Server Error (ErrorResponse)
503Service Unavailable (ErrorResponse)
Open this operation in the API reference