> ## Documentation Index
> Fetch the complete documentation index at: https://detrack.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve a depot

> GET /dn/depots/{name} returns a single depot object, including geocoded location and address fields.

Fetch the details of one depot by its exact name. This is useful when you need to confirm the geocoded coordinates of a depot before assigning it to a route or job. The response includes the full address, geolocation array, and read-only `id`.


## OpenAPI

````yaml GET /dn/depots/{name}
openapi: 3.0.3
info:
  title: Detrack REST API v2
  version: '2.0'
  description: >-
    Detrack REST API v2. Checked against detrack-webapp origin/main (production)
    on 2026-09-29: dn_jobs.rb @ d246ad006, dn_depots.rb @ 2a5f387, dn_routes.rb
    @ 50a73a9, app_helper.rb @ d745ad2, dn_jobs_helper.rb @ d296e30,
    job_decorator.rb @ 3041da7, run_location_decorator.rb @ 0f0274d,
    vehicle_route_plan_decorator.rb and tsp_route_decorator.rb @ 7d1f3ef,
    data_export.rb @ ed4e135.
servers:
  - url: https://app.detrack.com/api/v2
security:
  - apiKey: []
tags:
  - name: Jobs
    description: Deliveries and collections.
  - name: Depots
    description: Saved warehouse and pickup locations.
  - name: Routes
    description: Optimized multi-stop plans across vehicles.
paths:
  /dn/depots/{name}:
    get:
      tags:
        - Depots
      summary: Retrieve a depot
      operationId: retrieveDepot
      parameters:
        - name: name
          in: path
          required: true
          schema:
            type: string
            example: Main Depot
          description: Exact depot name, URL-encoded.
      responses:
        '200':
          description: The depot.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Depot'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          description: No depot has that name.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: not_found
                message: Depot not found
        default:
          $ref: '#/components/responses/ServerError'
components:
  schemas:
    Depot:
      type: object
      properties:
        id:
          type: string
          readOnly: true
          example: 68f0d416e8ec54cbf4a04dba
        name:
          type: string
          example: Main Depot
        address:
          type: string
          example: >-
            SM Megamall, EDSA corner Doña Julia Vargas Ave, Mandaluyong, 1550
            Metro Manila
        addr_1:
          type: string
          nullable: true
        addr_2:
          type: string
          nullable: true
        addr_3:
          type: string
          nullable: true
        zip_code:
          type: string
          nullable: true
        country:
          type: string
          nullable: true
        city:
          type: string
          nullable: true
        state:
          type: string
          nullable: true
        country_id:
          type: string
          nullable: true
          readOnly: true
        location:
          type: array
          readOnly: true
          description: Coordinates as `[longitude, latitude]`.
          items:
            type: number
          example:
            - 121.055626
            - 14.583941
        address_lat:
          type: number
          readOnly: true
          example: 14.583941
        address_lng:
          type: number
          readOnly: true
          example: 121.055626
    Error:
      type: object
      properties:
        code:
          type: string
          example: not_found
        message:
          type: string
          example: Could not find job with this DO number
  responses:
    Unauthorized:
      description: >-
        The API key is missing or invalid. A missing `X-API-KEY` returns `{
        "error": "Missing Authorization header" }`; an invalid key returns `{
        "code": "invalid_key", "message": "Invalid key" }`.
      content:
        application/json:
          schema:
            oneOf:
              - type: object
                title: Missing key
                required:
                  - error
                properties:
                  error:
                    type: string
                    example: Missing Authorization header
              - type: object
                title: Invalid key
                required:
                  - code
                properties:
                  code:
                    type: string
                    example: invalid_key
                  message:
                    type: string
                    example: Invalid key
          example:
            code: invalid_key
            message: Invalid key
    Forbidden:
      description: Your API key's user doesn't have permission for this action.
      content:
        application/json:
          schema:
            type: object
            properties:
              code:
                type: string
                example: forbidden
          example:
            code: forbidden
    ServerError:
      description: >-
        Unexpected server error. Retry with exponential backoff, and contact
        Detrack support if it persists.
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-KEY
      description: Your Detrack API key, from **Integrations > API Key** in the dashboard.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.