> For the complete documentation index, see [llms.txt](https://docs.mburger.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mburger.cloud/api-docs-1/sections/get-section-1.md).

# Get Section

{% hint style="info" %}
How to obtain a section. 

You can use the section ID or the slug.
{% endhint %}

{% tabs %}
{% tab title="Request" %}
`GET https://mburger.cloud/api/sections/<id-or-slug>`

```bash
curl https://mburger.cloud/api/sections/<id-or-slug>?include=elements
-H "Accept: application/json" 
-H "X-MBurger-Token: <token>" 
-H "X-MBurger-Version: 3"
```

#### &#x20;URL Parameters

| Name       | Type        | Required | Description                                  |
| ---------- | ----------- | -------- | -------------------------------------------- |
| id-or-slug | int, string | Yes      | Section id or the value of the slug element. |

{% hint style="info" %}
If you are using the slug (and the project has Multi-language enabled) make sure to include the correct locale in the request.
{% endhint %}

#### &#x20;Parameters

| Name                    | Type    | Required | Description                                                                                                                                                             |
| ----------------------- | ------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| locale                  | string  | No       | For multi-language projects, specify the desired locale for elements values. If locale is not provided or found the project fallback will be used.                      |
| force\_locale\_fallback | boolean | No       | If true and the requested locale is empty, the fallback locale is returned. Default false.                                                                              |
| include                 | string  | No       | Specify which relations to load and include in response.                                                                                                                |
| image\_format           | string  | No       | Specify which image dimension to include in response. Values are *thumb*, *medium*, *large* and *original*. Default is *medium*.                                        |
| use\_slug               | string  | No       | If true forces MBurger to use the slug.                                                                                                                                 |
| distance                | string  | No       | With this parameter and providing your latitude and longitude the distance between you and every section is added in the response. Example: distance=42.24234,13.543344 |
| {% endtab %}            |         |          |                                                                                                                                                                         |

{% tab title="Response" %}
When successful, a HTTP 200 and JSON like this is returned:

```bash
{
  "status_code": 0,
  "body": {
    "id": 1,
    "order": 1,
    "all_locales": false,
    "visible": true,
    "in_evidence": false,
    "available_at": 1546599965,
    "updated_at": 1546599966,
    "elements": {
      "title": {
        "id": 2,
        "name": "title",
        "type": "text",
        "order": 1,
        "options": null,
        "locale": "en",
        "value": "Main Home"
      },
      "image": {
        "id": 3,
        "name": "image",
        "type": "image",
        "order": 2,
        "options": null,
        "locale": "en",
        "value": [
          {
            "id": 1,
            "url": "https://cdn.mburger.cloud/storage/1/conversions/image-medium.jpg",
            "size": 45166,
            "mime_type": "image/jpeg"
          }
        ]
      },
      "content": {
        "id": 4,
        "name": "content",
        "type": "textarea",
        "order": 3,
        "options": null,
        "locale": "en",
        "value": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer nec nisi et sapien tincidunt sodales."
      }
    }
  }
}
```

{% endtab %}
{% endtabs %}