== LOCATIONS

The Locations resource is used to list, create, and update locations.

=== Retrieve a location

A `GET` request will retrieve the details of a location.

==== Response fields

include::{snippets}/locations-get-example/response-fields.adoc[]

==== Example request

include::{snippets}/locations-get-example/http-request.adoc[]

==== Example response

include::{snippets}/locations-get-example/http-response.adoc[]

=== Create a location

A `POST` request will create a new location.

==== Request fields

include::{snippets}/locations-create-example/request-fields.adoc[]

==== Response fields

include::{snippets}/locations-create-example/response-fields.adoc[]

==== Example request

include::{snippets}/locations-create-example/http-request.adoc[]

==== Example response

include::{snippets}/locations-create-example/http-response.adoc[]

=== Create children for a location

A `POST` request will create a location.

include::{snippets}/locations-children-create-example/request-fields.adoc[]

==== Response fields

include::{snippets}/locations-children-create-example/response-fields.adoc[]

==== Example request

include::{snippets}/locations-children-create-example/http-request.adoc[]

==== Example response

include::{snippets}/locations-children-create-example/http-response.adoc[]

=== Update a location

A `PUT` request will update the details of a location.

==== Request fields

include::{snippets}/locations-update-example/request-fields.adoc[]

==== Response fields

include::{snippets}/locations-update-example/response-fields.adoc[]

==== Example request

include::{snippets}/locations-update-example/http-request.adoc[]

==== Example response

include::{snippets}/locations-update-example/http-response.adoc[]

=== Retrieve a location lookup

A `GET` request will retrieve the details of a location lookup.

==== Response fields

include::{snippets}/location-get-lookup-example/response-fields.adoc[]

==== Example request

include::{snippets}/location-get-lookup-example/http-request.adoc[]

==== Example response

include::{snippets}/location-get-lookup-example/http-response.adoc[]