# Get depot set

Retrieves detailed information on the given depot set.

Endpoint: GET /locations/depot-sets/{business_id}
Version: 1.5.0
Security: clientCredentials

## Path parameters:

  - `business_id` (string, required)
    The unique identifier of an entity

## Response 200 fields (application/json):

  - `business_id` (string)
    The unique identifier for the depot set.
    Example: "cb1fb12c-0abc-413c-a69d-63c62566685f"

  - `name` (string, required)
    The name of the depot set
    Example: "Belgian Depots"

  - `depots` (array, required)
    List of depots in this set

  - `depots.business_id` (string, required)
    Identifier of a depot unique within the set
    Example: "depot-ghent"

  - `depots.name` (string, required)
    Name of the depot
    Example: "Depot Ghent"

  - `depots.address` (object, required)
    Address information for the depot.
When geo_point is provided, address fields (address_line, city, zip_code, country_code) are optional.
When geo_point is omitted, address fields must be provided so that the address can be geo-coded.

  - `depots.address.address_line` (string)
    The part of the address that includes the street name, house number, bus number etc. 
Required when omitting geo_point.
    Example: "Voordries 41"

  - `depots.address.city` (string)
    City name. Required when omitting geo_point.
    Example: "Oosterzele"

  - `depots.address.zip_code` (string)
    Postal code. Required when omitting geo_point.
    Example: "9860"

  - `depots.address.country_code` (string)
    represents the ISO3166-1 alpha-2 two letter country codes

  - `depots.address.geo_point` (object)

  - `depots.address.geo_point.latitude` (number, required)
    Example: 50.9514048

  - `depots.address.geo_point.longitude` (number, required)
    Example: 3.8067878

  - `depots.address.geo_point.resolved` (object)
    Geocoding resolution information.

  - `depots.address.geo_point.resolved.geocoded` (boolean)
    Indicates if the provided address was geocoded or not.
Geocoding only happens when the provided address does not yet have a geo-point.
    Example: true

  - `depots.address.geo_point.resolved.address` (string)
    The address that matches the resolved geo-point. Only present when geocoded is true.
    Example: "Voordries 41, 9860 Oosterzele"

  - `depots.address.geo_point.resolved.precision` (integer)
    Geocoding confidence score from 0-10.
10 indicates 100% confidence that the coordinates match the provided address. 0 indicates no confidence in the match.
Only present when geocoded is true.
    Example: 9

  - `depots.stop_time` (string)
    Stop time at the depot in ISO-8601 duration format
    Example: "PT5M"

## Response 404 fields (application/problem+json):

  - `type` (string, required)
    An absolute URI that identifies the problem type.  When dereferenced,
it SHOULD provide human-readable documentation for the problem type
(e.g., using HTML).
    Example: "https://developer.conundra.eu/developer-portal/problem/#constraint-violation"

  - `title` (string, required)
    A short, summary of the problem type. Written in english and readable
for engineers (usually not suited for non technical stakeholders and
not localized)
    Example: "Bad Request"

  - `status` (integer, required)
    The HTTP status code generated by the origin server for this occurrence
of the problem.
    Example: 400

  - `detail` (string, required)
    A human readable explanation specific to this occurrence of the
problem.
    Example: "Bad request. See violations for more details."

  - `violations` (array)

  - `violations.field` (string)
    A reference to the field in the request that triggered this violation.
    Example: "limit"

  - `violations.message` (string, required)
    A message explaining the violation in the referenced field.
    Example: "Limit must be strictly positive."


## Response 401 fields