# Get paginated depots

Endpoint: GET /depots
Version: 1.0.0
Security: M2X_auth_application

## Query parameters:

  - `lastDepotId` (string)
    The last lastDepotId, query would start after that.

  - `pagesToReturn` (integer)
    Number of depots to return, default/max 20.

## Response 200 fields (application/json):

  - `lastDepotId` (string)
    Document from where the page starts

  - `pagesToReturn` (integer)
    Page size

  - `depots` (array)
    Queried locations

  - `depots.name` (string)
    Example: "A test depot"

  - `depots.created` (string)

  - `depots.updated` (string)

  - `depots.location` (object)

  - `depots.location.addressText` (string, required)

  - `depots.location.latitude` (number, required)

  - `depots.location.longitude` (number, required)

  - `depots.location.locationName` (string, required)

  - `depots.location.locationId` (string,null)
    The M2X internal location id. When a location is manually created in M2X, this is a randomly generated unique identifier. If creating locations via API, the caller can set the Location ID.

  - `depots.location.externalId` (string,null)
    An optional external identifier assigned to the location. This ID can be provided when creating the location and is typically used for cross-system referencing or integration with external data sources.

  - `depots.location.timezone` (string)
    IANA (aka TZ database) timezone name
    Example: "Pacific/Auckland"

  - `depots.location.properties` (object,null)

  - `depots.deleted` (boolean)

  - `depots.published` (boolean)

  - `latestDepotId` (integer)
    Last document in this batch