Private Beta · API v1

Build on the
Fashion OS.

Plug into a fashion ecosystem where identity, creation, and commerce converge. We are opening a limited sandbox for partners who want to prototype against our core services.

Apply for access
Private beta
fshnista-api · bash
$ curl -X POST https://api.fshnista.com/oauth/token -H "Content-Type: application/json" \ -d '{"grant_type":"client_credentials"}'   { "access_token": "eyJhbGciOiJSUzI1NiJ9...", "token_type": "Bearer", "expires_in": 3600 }   $ curl -H "Authorization: Bearer $TOKEN" \ https://api.fshnista.com/v1/me   { "id": "usr_01HXYZ...", "handle": "@yourbrand", "twin_active": true }
What you can build
Identity & Auth
Authenticate users via OAuth 2.0 and connect to their FSHNiSTA profile. Scoped permissions keep access precise.
GET /v1/me
Storefronts
Read and write creator storefront data. Manage listings, inventory, and visibility across the platform.
GET /v1/storefronts/{id}
Affiliate Links
Create, track, and report on affiliate links and conversions. Build monetization flows for your audience.
GET /v1/affiliates/links
Webhooks
Subscribe to real-time events. Every delivery is signed with a secret so you can verify authenticity on your end.
POST /v1/webhooks
Virtual Try-On
Request try-on sessions for approved use cases. Launch an immersive try-on experience directly from your product page.
POST /v1/tryon/sessions
Design Vault
Sync assets with IP-safe controls. Upload collections, manage rights, and distribute to approved partners programmatically.
POST /v1/assets
Authentication

We support OAuth 2.0 and API keys in the sandbox. Production uses OAuth 2.0 with scoped permissions. All tokens expire after 3600 seconds — your client should refresh automatically using the client credentials flow.

OAuth 2.0 
POST /oauth/token
Content-Type: application/json

{
  "grant_type": "client_credentials",
  "client_id":  "your_client_id",
  "client_secret": "your_secret"
}

// Response
{
  "access_token": "eyJhbGci...",
  "token_type": "Bearer",
  "expires_in": 3600
}

We expose both REST v1 for simple integrations and GraphQL for complex reads and joins. Schema exposure is staged — early partners receive schema previews in the partner portal.

cURL 
curl -X GET \
  https://api.fshnista.com/v1/storefronts/{id} \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

// Response
{
  "id": "sf_01HXYZ...",
  "handle": "@yourbrand",
  "products_count": 24,
  "status": "active"
}
Endpoint reference
GET
/v1/me
Authenticated user profile and twin status
GET
/v1/storefronts/{id}
Storefront data, settings and metadata
POST
/v1/storefronts/{id}/products
Create or update a product listing
GET
/v1/affiliates/links
List affiliate links and performance data
POST
/v1/tryon/sessions
Request a virtual try-on session token
POST
/v1/assets
Upload to Design Vault with IP controls
GET
/v1/inventory
Inventory by storefront — ?storefrontId=
Webhook events
order.createdCommerce
order.fulfilledCommerce
product.updatedStorefront
design.publishedDesign Vault
affiliate.clickAffiliate
affiliate.conversionAffiliate
tryon.session.createdTry-On
Getting started
01
Apply for access
Email partners@fshnista.com with your use case, expected volume, and timelines.
02
Receive credentials
We provision your sandbox org, client ID, and secret. Set your redirect URIs in the portal.
03
Authenticate
Call /oauth/token to get your Bearer token, then hit /v1/me to confirm the connection.
04
Register & prototype
Register your webhook endpoint, build your use case, and share feedback through support.
Rate limits
Default 100 requests per minute per client. Burstable tiers for approved partners. Backoff with Retry-After header on 429.
Data & compliance
GDPR-aligned data handling. Regional storage for EU data. Creator IP stays creator owned. Content moderation required.
Versioning
Versioned by major.minor.patch. Deprecation windows announced in the partner portal with at least 90 days notice.
On the roadmap
Public developer portal with self-serve keys, live docs, and usage analytics
Self-serve webhook UI with event replay and delivery logs
Expanded GraphQL schema covering events, recommendations, and twin data
Postman collection and OpenAPI 3.0 export for easy client generation
JavaScript and Python SDKs — private beta for sandbox partners
Mobile helpers for iOS and Android with native try-on session support

Ready to integrate?

Share your concept and technical scope. If you need help shaping the brief or mapping the data model, we are here before you write a single line.

Apply for sandbox access General questions