> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axiomancer.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Reports

> Two endpoints to generate branded PDF location reports and retrieve historical reports — bring Locus scoring into client deliverables and pitch decks.

## `GET` `/api/report`

<Note>Requires Bearer token.</Note>

Generate a branded PDF location report.

**Query parameters**

| Name      | Type   | Required | Default           | Description                        |
| --------- | ------ | -------- | ----------------- | ---------------------------------- |
| `lat`     | float  | ✓        |                   | Latitude.                          |
| `lng`     | float  | ✓        |                   | Longitude.                         |
| `name`    | string |          | `Location Report` | Report title / location name.      |
| `profile` | string |          | `general`         | Scoring profile.                   |
| `client`  | string |          | `Client`          | Client name for the report header. |

**Example**

```bash theme={null}
curl "https://axiomlocus.io/api/report?lat=37.7749&lng=-122.4194&name=Mission+District" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -o report.pdf
```

**Response**

```json theme={null}
# Binary PDF response
Content-Type: application/pdf
Content-Disposition: attachment; filename="axiom-locus-report-mission-district.pdf"
```

## `GET` `/api/places-photo`

Proxy for business photos. Supports both Places API (New) resource names and legacy photo references returned by `/api/location-data`.

**Query parameters**

| Name  | Type   | Required | Default | Description                                                                                                                                                                                                                                                        |
| ----- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `ref` | string | ✓        |         | Photo reference string from POI data. Must match either a Places API (New) resource name (`places/{place_id}/photos/{photo_id}`) or a legacy photo reference (8–2048 characters, `A–Z`, `a–z`, `0–9`, `_`, or `-`). Other formats return `400 Invalid ref format`. |
| `w`   | int    |          | `100`   | Image width in pixels. Values are clamped to the range `1`–`1600`; non-numeric values fall back to the default.                                                                                                                                                    |

**Example**

```bash theme={null}
curl "https://axiomlocus.io/api/places-photo?ref=Aap_uE...&w=200" -o photo.jpg
```

**Response**

```json theme={null}
# Binary JPEG response
Content-Type: image/jpeg
```