> For the complete documentation index, see [llms.txt](https://docs.echo3d.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.echo3d.com/api/locate.md).

# Locate

## Save a location

<mark style="color:green;">`POST`</mark> `https://api.echo3D.com/location`

This endpoint allows you to save the location from where a query is made or the location of the user.

#### Request Body

| Name                                      | Type   | Description                                                                                                                             |
| ----------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| key<mark style="color:red;">\*</mark>     | string | Your API key.                                                                                                                           |
| email<mark style="color:red;">\*</mark>   | string | Your email address                                                                                                                      |
| userKey<mark style="color:red;">\*</mark> | string | Your authentication key                                                                                                                 |
| secKey<mark style="color:red;">\*</mark>  | string | Your Secret key. Only if enabled through the [Security page](/web-console/manage-pages/collections-and-sharing/security.md#secret-key). |
| entryID<mark style="color:red;">\*</mark> | string | The entry ID of the content entry being accessed.                                                                                       |
| lat<mark style="color:red;">\*</mark>     | string | The latitude coordinate of the device accessing the content entry.                                                                      |
| long<mark style="color:red;">\*</mark>    | string | The longitude coordinates of the device accessing the content entry.                                                                    |
| countryCode                               | object | The two-letter country code of the location of the device accessing the content entry.                                                  |

{% tabs %}
{% tab title="200 The location will be saved an associated with the entry" %}

```
N/A
```

{% endtab %}
{% endtabs %}

**This API query must include a location.** You must either send location coordinates (longitude and latitude) **or** a [two-letter country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).