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

# List Studios

> Public studio discovery endpoint backed by the current runtime adapter.

<Info>
  **Posture:** Public no-auth read. This endpoint is part of the current promoted public surface.
</Info>

<Warning>
  **Write boundary:** Public writes are blocked. Do not build production flows assuming mutation is live on this route family.
</Warning>

Canonical request URL: `https://api.tattooapi.com/api/v1/studios`.

`GET /studios` is public and does not require authentication.

## Query Parameters

| Parameter                         | Type    | Notes                                    |
| --------------------------------- | ------- | ---------------------------------------- |
| `page`                            | integer | Default `1`                              |
| `limit`                           | integer | Default `20`, max `50`                   |
| `search`                          | string  | Name, description, or city search        |
| `city`                            | string  | Exact city filter                        |
| `state`                           | string  | Exact state filter                       |
| `price_range`                     | string  | Comma-separated `$`, `$$`, `$$$`, `$$$$` |
| `rating`                          | number  | Minimum rating                           |
| `verified`                        | boolean | Filter by verification flag              |
| `featured`                        | boolean | Filter by featured flag                  |
| `latitude`, `longitude`, `radius` | number  | Geographic search                        |
| `sort`, `order`                   | string  | Sorting controls                         |

## Response Shape

The current endpoint uses the legacy paginated wrapper while the record source is moving through the runtime adapter:

```json theme={"dark"}
{
  "data": [
    {
      "id": "uuid",
      "name": "Ink Masters Studio",
      "description": "Premier tattoo studio",
      "address": "123 Main Street",
      "city": "Los Angeles",
      "state": "CA",
      "country": "USA",
      "rating": 4.8,
      "review_count": 127,
      "specialties": [],
      "verified": false,
      "featured": false,
      "provenance": {
        "recordState": "normalized",
        "sourceType": "directory_scrape",
        "originAuthority": "system_inference",
        "sourceUrl": null,
        "sourceCollectedAt": null,
        "licenseStatus": "rights_unknown",
        "consentLevel": "recommendation_only",
        "sourceNotes": []
      },
      "trust": {
        "verificationStatus": "unverified",
        "approvalStatus": "pending_review",
        "visibility": "public",
        "culturalSensitivityLevel": "none",
        "trustNotes": []
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1,
    "hasNext": false,
    "hasPrev": false
  },
  "error": null
}
```

<Tip>
  This endpoint is one of the first stable ontology-backed projection candidates. The wrapper remains legacy for now, but studio records are being normalized with source lineage.
</Tip>