# Get the store profile

The store name, contact details, VAT number, commercial registration, national address and pickup address, as the merchant filled them.

```http
GET https://larm.sa/stores/{storeId}/v1/store
```

Scope: `store:read`

A field the merchant has not filled is `null`. A delivery app reads `pickup_address` to know where to collect shipments. An accounting app reads `legal_name`, `vat_number` and `commercial_registration` for its documents. See [Accounting and invoices](/guides/accounting).

## Response

| Field | Type | Required | Description |
|---|---|---|---|
| `data` | object | yes |  |
| `data.id` | string (uuid) | yes |  |
| `data.name` | string \| null | no |  |
| `data.legal_name` | string \| null | no | The legal name, as on the commercial registration. |
| `data.domain` | string \| null | no |  |
| `data.url` | string \| null (uri) | no |  |
| `data.currency` | string | yes | One of: `SAR`. |
| `data.locale` | string | yes | One of: `ar`. |
| `data.country` | string | yes | One of: `SA`. |
| `data.logo_url` | string \| null | no |  |
| `data.email` | string \| null | no |  |
| `data.phone` | string \| null | no |  |
| `data.vat_number` | string \| null | no | The VAT number, or null when the merchant has not filled it. |
| `data.commercial_registration` | string \| null | no |  |
| `data.national_address` | string \| null | no |  |
| `data.pickup_address` | object \| null | no | The pickup address the merchant filled, or null. |
| `data.pickup_address.name` | string \| null | no |  |
| `data.pickup_address.contact_name` | string \| null | no |  |
| `data.pickup_address.phone` | string \| null | no |  |
| `data.pickup_address.email` | string \| null | no |  |
| `data.pickup_address.country` | string \| null | no |  |
| `data.pickup_address.city` | string \| null | no |  |
| `data.pickup_address.district` | string \| null | no |  |
| `data.pickup_address.street` | string \| null | no |  |
| `data.pickup_address.postal_code` | string \| null | no |  |
| `execution` | object | no | Who executed the request: the app, version, installation and store. Field names here are camelCase. |
| `execution.appId` | string (uuid) | no |  |
| `execution.versionId` | string (uuid) | no |  |
| `execution.installationId` | string (uuid) | no |  |
| `execution.storeId` | string (uuid) | no |  |
| `execution.requestId` | string (uuid) | no |  |
| `execution.generation` | integer | no |  |
| `execution.routeEpoch` | integer | no |  |
| `execution.appAuthEpoch` | integer | no |  |
| `execution.grantRevision` | integer | no |  |
| `meta` | object | yes |  |
| `meta.request_id` | string (uuid) | no | The request ID; include it in any support request. |


## Example request

```bash
curl -X GET "https://larm.sa/stores/$STORE_ID/v1/store" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```


## Example response (200)

```json
{
  "data": {
    "id": "5b1d7a62-0c4e-4f38-9a51-2e7b3c9d8f10",
    "name": "Charge Store",
    "legal_name": "Charge Trading Co.",
    "domain": "store.example",
    "url": "https://store.example",
    "currency": "SAR",
    "locale": "ar",
    "country": "SA",
    "logo_url": "https://cdn.example/logo.webp",
    "email": "help@store.example",
    "phone": "+966512340000",
    "vat_number": "310000000000003",
    "commercial_registration": "1010000000",
    "national_address": "RAAA1234",
    "pickup_address": {
      "name": "Main warehouse",
      "contact_name": "Khalid",
      "phone": "+966512340000",
      "email": "help@store.example",
      "country": "SA",
      "city": "Riyadh",
      "district": "Al Malqa",
      "street": "Anas Ibn Malik Road",
      "postal_code": "13521"
    }
  },
  "execution": {
    "appId": "1f2e3d4c-5b6a-4978-8695-a4b3c2d1e0f9",
    "versionId": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
    "installationId": "c7e4a1f2-6b3d-4e8a-9c05-1d2f3a4b5c6d",
    "storeId": "5b1d7a62-0c4e-4f38-9a51-2e7b3c9d8f10",
    "requestId": "3f0c2b8e-7a51-4c1e-9d0a-5b6f1e2d4c3a",
    "generation": 1,
    "routeEpoch": 4,
    "appAuthEpoch": 1,
    "grantRevision": 2
  },
  "meta": {
    "request_id": "3f0c2b8e-7a51-4c1e-9d0a-5b6f1e2d4c3a"
  }
}
```


## Errors

| HTTP | Code | Meaning |
|---|---|---|
| 403 | `SCOPE_REQUIRED` | The token does not carry the required scope. |