Skip to main content

Base URL And Version

Use https://api.tattooapi.com for new integrations. Resource reads such as studios, artists, search, portfolios, and designs require api-version=2026-07-01-preview.
Health checks do not require the version parameter. Owner reads use explicit /api/v1/me/* paths. Portfolio intake uses /api/private/portfolio-intake/v1/*. The https://api.tattooapi.com/api/v1 base remains available for existing compatibility clients.

Functions

Public writes are blocked. Submission, approval, and public publication are separate steps.

Requests And Errors

Use Authentication for credentials and permissions. Missing or invalid credentials return 401; insufficient access returns 403. Canonical resource requests with a missing or unsupported version return 400. Follow the pagination limits and filters documented on each endpoint. Response envelopes differ between endpoints. Use the specific reference page and OpenAPI schema; do not assume every response has a success/data wrapper. See Project Status for availability and API Surface Map for the supported endpoint groups.