APIs

Capability groups that map to tattoo products and operational flows.

Six capability groups organized around how tattooing actually works — not how a generic local business API thinks it should. Browse by domain, then head to docs.tattoo.dev for request schemas, response shapes, and SDKs.

stable

Artists & studios

Structured profiles with style taxonomy, travel schedules, studio affiliations, and geo-indexed identity records. Supports solo artists, multi-chair studios, and guest-artist arrangements — not one forced paradigm.

GET /artists
stable

Portfolios & media

Healed-work collections, style tagging, piece metadata, and portfolio organization built for discovery and trust conversion. Portfolios are a first-class object, not a photo array bolted onto a profile.

GET /portfolios
stable

Discovery & listings

Search-ready records indexed by city, style, artist, and availability. Powers marketplace surfaces, map layers, and category views without you reverse-engineering the tattoo data model.

GET /listings
stable

Booking & inquiry flows

Inquiry capture, deposit state transitions, availability windows, and consent tracking — modeled from how real studios qualify clients, not how a generic calendar app thinks they should.

POST /bookings/inquiries
stable

Reviews & trust

Artist quality signals, studio credibility markers, verified healed work, and tattoo-specific social proof. Trust is a first-class field in the data model — not a star rating bolted on as an afterthought.

GET /reviews
beta

Messaging & automation

Webhook-driven workflow triggers, follow-up state, conversation handling, and operational signals. Connect booking events to your messaging layer with clean, structured payloads — not polling.

POST /messages

Start Here

Use docs as the canonical entry point.

Open implementation details on docs.tattoo.dev, then route access and partnership conversations through the platform site.

Portfolio intelligence

From texted images to governed portfolio signals.

The next portfolio lane turns real studio intake into structured creative context without bypassing ownership, consent, or review. Builders get clean projections; private media, raw messages, and worker credentials stay behind TattooAPI governance.

Inbox signal

SMS and MMS portfolio intake

The messaging layer stays the visible inbox. TattooAPI receives the inbound media event, classifies it, and keeps raw phone data out of public docs and projections.

Private staging

Media staged with source context

Portfolio media is staged with owner, artist, source, consent, and rights context before it can become a trusted creative proof object.

AI agents

AI agents for the tattoo industry

Tattoo-native agents can understand style, placement, reference material, artist attribution, and portfolio context without treating tattoo work like generic image content.

Review gate

Approved portfolio record

Human or governed review decides what graduates into approved portfolio records and what remains private, blocked, or needs owner clarification.

Current posture

Read-first public API. Owner-gated writes. Review before distribution.

The public surface can describe approved portfolios. Owner-scoped write routes and worker enrichment remain gated until identity, consent, rights, and review posture are explicit.