# Get location details

Fetches location details.

```http
GET https://api.pozy.ai/v1/accounts/{accountId}/gmb-location-details
```

- Area: Google Business / Google Business Location Details
- Auth: Authorization: Bearer pz_live_...

## Path parameters

- `accountId` (string, required)

## Query parameters

- `locationId` (string)
- `readMask` (string)

## Example request

```bash
curl -X GET "https://api.pozy.ai/v1/accounts/696e0b682d0a31188e7a2ba9/gmb-location-details" \
  -H "Authorization: Bearer $POZY_API_KEY"
```

```ts
const res = await fetch("https://api.pozy.ai/v1/accounts/696e0b682d0a31188e7a2ba9/gmb-location-details", {
  headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data?.error ?? `Request failed with status ${res.status}`);
console.log(data);
```

```python
import os
import requests

resp = requests.get(
    "https://api.pozy.ai/v1/accounts/696e0b682d0a31188e7a2ba9/gmb-location-details",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
print(resp.json())
```

## Response 200

- `success`, boolean
- `accountId`, string
- `locationId`, string
- `location`, object: Can be null
  - `name`, string: Can be null
  - `placeId`, string: Can be null
  - `reviewUrl`, string: Can be null
  - `mapsUri`, string: Can be null
  - `isVerified`, boolean
- `title`, string
- `regularHours`, object
  - `periods`, array of object
    - `openDay`, string: One of `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY`, `SUNDAY`
    - `openTime`, string
    - `closeDay`, string
    - `closeTime`, string
- `specialHours`, object
  - `specialHourPeriods`, array of object
    - `startDate`, object
      - `year`, integer
      - `month`, integer
      - `day`, integer
    - `endDate`, object
      - `year`, integer
      - `month`, integer
      - `day`, integer
    - `openTime`, string
    - `closeTime`, string
    - `closed`, boolean
- `profile`, object
  - `description`, string
- `websiteUri`, string
- `phoneNumbers`, object
  - `primaryPhone`, string
  - `additionalPhones`, array of string
- `categories`, object
  - `primaryCategory`, object
    - `name`, string
    - `displayName`, string
  - `additionalCategories`, array of object
    - `name`, string
    - `displayName`, string
- `serviceItems`, array of object
  - `structuredServiceItem`, object
    - `serviceTypeId`, string
    - `description`, string
  - `freeFormServiceItem`, object
    - `category`, string
    - `label`, object
      - `displayName`, string
      - `languageCode`, string
  - `price`, object
    - `currencyCode`, string
    - `units`, string
    - `nanos`, integer

```json
{
  "success": true,
  "accountId": "696e0b682d0a31188e7a2ba9",
  "locationId": "6e99c3dd69982b334a43b0b2",
  "location": {
    "name": "Acme",
    "placeId": "6c20e662d7040845c9a89145",
    "reviewUrl": "https://pozy.ai/media/example-1.jpg",
    "mapsUri": "string",
    "isVerified": true
  },
  "title": "Launch day",
  "regularHours": {
    "periods": [
      {
        "openDay": "MONDAY",
        "openTime": "string",
        "closeDay": "string",
        "closeTime": "string"
      }
    ]
  },
  "specialHours": {
    "specialHourPeriods": [
      {
        "startDate": {
          "year": 1,
          "month": 1,
          "day": 1
        },
        "endDate": {
          "year": 1,
          "month": 1,
          "day": 1
        },
        "openTime": "string",
        "closeTime": "string",
        "closed": true
      }
    ]
  },
  "profile": {
    "description": "A short description"
  },
  "websiteUri": "string",
  "phoneNumbers": {
    "primaryPhone": "+14155550123",
    "additionalPhones": [
      "+14155550123"
    ]
  },
  "categories": {
    "primaryCategory": {
      "name": "Acme",
      "displayName": "Acme"
    },
    "additionalCategories": [
      {
        "name": "Acme",
        "displayName": "Acme"
      }
    ]
  },
  "serviceItems": [
    {
      "structuredServiceItem": {
        "serviceTypeId": "6d4297c0b29cd9542de9fe72",
        "description": "A short description"
      },
      "freeFormServiceItem": {
        "category": "string",
        "label": {
          "displayName": "Acme",
          "languageCode": "string"
        }
      },
      "price": {
        "currencyCode": "string",
        "units": "string",
        "nanos": 1
      }
    }
  ]
}
```
