API
Kumir developers
Native iOS/Android and partner integrations use versioned /api/v1. The machine-readable contract is OpenAPI 3.1 at GET /api/v1/openapi. Do not invent Stripe, APNs, FCM, or OAuth keys — missing providers return 501 or log-only, never a fake success.
Auth: POST /api/v1/auth/login returns an HS256 access token (1 hour) and a rotating refresh token (30 days). Send Authorization: Bearer … and X-Fameo-Channel: ios|android. Health probes /api/v1/health and /ready stay unauthenticated.
about
accessibility
account
admin
GET /api/v1/admin/analytics
Admin marketplace analytics cards (optional q) · Admin
GET /api/v1/admin/applications
GET admin · applications · Admin
GET /api/v1/admin/audit
Append-only admin audit log (q + action) · Admin
GET /api/v1/admin/categories
Admin taxonomy list (q + active/archived) · Admin
POST /api/v1/admin/categories
Create a browse category (slug stays stable) · Admin
PATCH /api/v1/admin/categories/{slug}
Rename, reorder, nest, or archive a category · Admin
GET /api/v1/admin/leads
Admin business leads (q + sales/license_extension/support) · Admin
GET /api/v1/admin/merch
Admin merch queue (q + status) with refund/credit/chargeback flags · Admin
POST /api/v1/admin/merch/{publicId}/chargeback
Record a merch payment dispute and claw unpaid earnings · Admin
POST /api/v1/admin/merch/{publicId}/refund
Refund merch to card or issue Kumir credit · Admin
GET /api/v1/admin/newsletter
Admin newsletter signups (q email) · Admin
POST /api/v1/admin/newsletter/remove
Admin remove a newsletter email (audited) · Admin
GET /api/v1/admin/ops
GET admin · ops · Admin
GET /api/v1/admin/orders
Admin order queue (q + status) with override action flags · Admin
POST /api/v1/admin/orders/{publicId}/chargeback
POST admin · orders · :publicId · chargeback · Admin
POST /api/v1/admin/orders/{publicId}/credit
POST admin · orders · :publicId · credit · Admin
POST /api/v1/admin/orders/{publicId}/expire
POST admin · orders · :publicId · expire · Admin
POST /api/v1/admin/orders/{publicId}/refund
POST admin · orders · :publicId · refund · Admin
POST /api/v1/admin/orders/{publicId}/remake
POST admin · orders · :publicId · remake · Admin
GET /api/v1/admin/overview
Admin ops home (optional q, queue counts + GMV + repeat) · Admin
GET /api/v1/admin/partners
Admin partner applications (q + pending/approved/rejected/all) · Admin
POST /api/v1/admin/partners/approve
POST admin · partners · approve · Admin
POST /api/v1/admin/partners/reject
POST admin · partners · reject · Admin
GET /api/v1/admin/payments
Admin payment ledger (q + succeeded/failed/refunded/pending) · Admin
GET /api/v1/admin/promos
Admin promo codes (q + active/off) · Admin
PATCH /api/v1/admin/promos
Activate or deactivate a promo code · Admin
POST /api/v1/admin/promos
Create an honest percent or fixed promo · Admin
GET /api/v1/admin/refunds
Admin refunds + chargebacks (q + kind/status) · Admin
GET /api/v1/admin/reports
Admin AUP reports (q + open/resolved/dismissed/all) · Admin
POST /api/v1/admin/reports/resolve
POST admin · reports · resolve · Admin
GET /api/v1/admin/reviews
Admin review queue (q + public/hidden) · Admin
POST /api/v1/admin/reviews/visibility
Hide or publish a fan review on storefronts · Admin
GET /api/v1/admin/settings
Admin runtime flags (optional q, no secret values) + host readiness issues · Admin
GET /api/v1/admin/stars
Admin star catalog with merchandising, payout hold, and intro/approve flags · Admin
POST /api/v1/admin/stars/approve
POST admin · stars · approve · Admin
POST /api/v1/admin/stars/merchandising
Toggle Featured / Hot / SAG / Kids / Instant or pin Top 10 · Admin
POST /api/v1/admin/stars/payout-hold
Place or release an AML payout hold · Admin
POST /api/v1/admin/stars/reject
POST admin · stars · reject · Admin
GET /api/v1/admin/support
GET admin · support · Admin
GET /api/v1/admin/support/{userId}
GET admin · support · :userId · Admin
POST /api/v1/admin/support/impersonate
POST admin · support · impersonate · Admin
POST /api/v1/admin/support/impersonate/stop
POST admin · support · impersonate · stop · Admin
GET /api/v1/admin/users
Admin user directory (q + active/banned) with ban/unban flags · Admin
POST /api/v1/admin/users/ban
POST admin · users · ban · Admin
POST /api/v1/admin/users/unban
POST admin · users · unban · Admin
auth
POST /api/v1/auth/forgot
Request a password reset (same response if unknown email) · Public
POST /api/v1/auth/login
Email + password → HS256 access + refresh tokens · Public
POST /api/v1/auth/logout
Revoke refresh token; optional deviceToken drops push registration · Public
POST /api/v1/auth/oauth
Native Google/Apple id-token sign-in · Public
GET /api/v1/auth/oauth/callback
GET auth · oauth · callback · Public
POST /api/v1/auth/oauth/exchange
POST auth · oauth · exchange · Public
GET /api/v1/auth/oauth/start
GET auth · oauth · start · Public
POST /api/v1/auth/refresh
Rotate refresh token; 401 expires the family · Public
POST /api/v1/auth/register
Create a fan account (COPPA DOB check, verification email) · Public
POST /api/v1/auth/reset
Consume a hashed reset token and set a new password · Public
GET /api/v1/auth/sso
Which Google/Apple providers are configured (501 if none) · Public
POST /api/v1/auth/verify
Confirm email with a hashed token · Public
POST /api/v1/auth/verify/resend
Resend email verification · Public
business
GET /api/v1/business/blog
Kumir for Business blog (optional q) · Public
GET /api/v1/business/blog/{slug}
Business blog post by slug · Public
GET /api/v1/business/browse
Kumir for Business catalog (optional q + category) · Optional bearer
GET /api/v1/business/contact
C4B contact sales topics (optional q) · Public
GET /api/v1/business/contact/{slug}
C4B contact sales topic by slug · Public
POST /api/v1/business/leads
POST business · leads · Bearer
GET /api/v1/business/license
C4B license extension topics (optional q) · Public
GET /api/v1/business/license/{slug}
C4B license extension topic by slug · Public
GET /api/v1/business/login
C4B business login topics (optional q) · Public
GET /api/v1/business/login/{slug}
C4B business login topic by slug · Public
POST /api/v1/business/register
Create a 13+ business buyer account · Public
GET /api/v1/business/signup
C4B business signup topics (optional q) · Public
GET /api/v1/business/signup/{slug}
C4B business signup topic by slug · Public
GET /api/v1/business/stories
Kumir for Business customer stories (optional q) · Public
GET /api/v1/business/stories/{slug}
Customer story by slug · Public
categories
contact
credits
GET /api/v1/credits
Gift card + wallet purchase history (optional q) · Bearer
POST /api/v1/credits
POST credits · Bearer
GET /api/v1/credits/{id}
GET credit purchase by id (poll after Stripe web checkout) · Bearer
POST /api/v1/credits/{id}/fail
POST credits · :id · fail · Bearer
POST /api/v1/credits/{id}/pay
Confirm sandbox credit pay or return Stripe web checkoutUrl · Bearer
POST /api/v1/credits/redeem
POST credits · redeem · Bearer
developers
devices
display
events
feed
GET /api/v1/feed
Following feed (optional q) · Bearer
POST /api/v1/feed/{postId}/like
POST feed · :postId · like · Bearer
POST /api/v1/feed/{postId}/replies
POST feed · :postId · replies · Bearer
GET /api/v1/feed/topics
Following feed policy topics (optional q) · Public
GET /api/v1/feed/topics/{slug}
Following feed policy topic by slug · Public
follow
following
forgot
giftcards
goals
guardian
health
help
home
inbox
GET /api/v1/inbox
Direct threads (optional q, cursor pagination) · Bearer
POST /api/v1/inbox
POST inbox · Bearer
GET /api/v1/inbox/{threadId}
GET inbox · :threadId (optional before cursor for older messages) · Bearer
POST /api/v1/inbox/{threadId}
POST inbox · :threadId · Bearer
GET /api/v1/inbox/topics
Kumir Direct policy topics (optional q) · Public
GET /api/v1/inbox/topics/{slug}
Kumir Direct policy topic by slug · Public
POST /api/v1/inbox/upload
POST inbox · upload · Bearer
jobs
kids
languages
leaderboard
legal
login
match
me
GET /api/v1/me
GET me · Bearer
POST /api/v1/me/delete
POST me · delete · Bearer
GET /api/v1/me/export
Download a JSON copy of the signed-in account (no secrets) · Bearer
POST /api/v1/me/password
POST me · password · Bearer
GET /api/v1/me/phone
Phone verification status (masked) · Bearer
POST /api/v1/me/phone
Request a hashed SMS OTP for phone verification · Bearer
POST /api/v1/me/phone/verify
Verify a phone OTP — never invents phoneVerifiedAt · Bearer
GET /api/v1/me/settings
GET me · settings · Bearer
PATCH /api/v1/me/settings
PATCH me · settings · Bearer
media
merch
GET /api/v1/merch/orders
Fan merch order history (optional q) · Bearer
POST /api/v1/merch/orders
POST merch · orders · Bearer
GET /api/v1/merch/orders/{publicId}
GET merch · orders · :publicId · Bearer
POST /api/v1/merch/orders/{publicId}/fail
POST merch · orders · :publicId · fail · Bearer
POST /api/v1/merch/orders/{publicId}/pay
Confirm sandbox merch pay or return Stripe web checkoutUrl · Bearer
GET /api/v1/merch/orders/topics
Fan merch purchase policy topics (optional q) · Public
GET /api/v1/merch/orders/topics/{slug}
Fan merch purchase policy topic by slug · Public
metrics
mobile
notifications
GET /api/v1/notifications
In-app notifications (optional category + q) · Bearer
POST /api/v1/notifications
Mark one or all in-app notifications read · Bearer
GET /api/v1/notifications/topics
Fan notification inbox policy topics (optional q) · Public
GET /api/v1/notifications/topics/{slug}
Fan notification inbox policy topic by slug · Public
occasions
openapi
orders
GET /api/v1/orders
Fan order history (optional tab + q) · Bearer
POST /api/v1/orders
Create a personal/business/DM booking (pending payment) · Bearer
GET /api/v1/orders/{publicId}
GET orders · :publicId · Bearer
GET /api/v1/orders/{publicId}/captions
GET orders · :publicId · captions · Bearer
POST /api/v1/orders/{publicId}/captions
POST orders · :publicId · captions · Bearer
POST /api/v1/orders/{publicId}/fail
Record a failed tender (real Payment row) · Bearer
GET /api/v1/orders/{publicId}/live/join
GET orders · :publicId · live · join · Bearer
POST /api/v1/orders/{publicId}/live/join
POST orders · :publicId · live · join · Bearer
POST /api/v1/orders/{publicId}/pay
Confirm sandbox/Stripe payment — never client-only success · Bearer
POST /api/v1/orders/{publicId}/reaction
POST orders · :publicId · reaction · Bearer
POST /api/v1/orders/{publicId}/retry
POST orders · :publicId · retry · Bearer
POST /api/v1/orders/{publicId}/review
POST orders · :publicId · review · Bearer
POST /api/v1/orders/clip
POST orders · clip · Bearer
POST /api/v1/orders/live
POST orders · live · Bearer
GET /api/v1/orders/review-prompt
GET orders · review-prompt · Bearer
GET /api/v1/orders/topics
Fan order history policy topics (optional q) · Public
GET /api/v1/orders/topics/{slug}
Fan order history policy topic by slug · Public
partner
GET /api/v1/partner
Partner dashboard + roster/earnings (optional q + eq) · Partner
POST /api/v1/partner/apply
POST partner · apply · Bearer
GET /api/v1/partner/connect
GET partner · connect · Partner
POST /api/v1/partner/connect
POST partner · connect · Partner
POST /api/v1/partner/payouts
POST partner · payouts · Partner
partners
press
privacy-choices
GET /api/v1/privacy-choices
Do Not Sell or Share status (GPC + account + cookie) · Optional bearer
POST /api/v1/privacy-choices
Submit or withdraw a Do Not Sell or Share request · Optional bearer
GET /api/v1/privacy-choices/topics
Privacy Choices policy topics (optional q) · Public
GET /api/v1/privacy-choices/topics/{slug}
Privacy Choices policy topic by slug · Public
promos
refunds
reports
reset
rewards
rewind
search
shop
signup
stars
GET /api/v1/stars
Server-side talent search + catalog ranking (optional q, kids, instant) · Optional bearer
GET /api/v1/stars/{username}
Public storefront (reviews, samples, related) · Optional bearer
GET /api/v1/stars/{username}/feed
Talent follower feed (optional q) · Optional bearer
GET /api/v1/stars/{username}/live-slots
GET stars · :username · live-slots · Optional bearer
GET /api/v1/stars/{username}/merch
GET stars · :username · merch · Optional bearer
GET /api/v1/stars/{username}/merch/{publicId}
GET stars · :username · merch · :publicId · Optional bearer
GET /api/v1/stars/{username}/reviews
Public storefront reviews (optional q) · Optional bearer
stickers
studio
GET /api/v1/studio/analytics
Studio analytics cards (optional q) · Talent
GET /api/v1/studio/analytics/topics
Studio analytics policy topics (optional q) · Public
GET /api/v1/studio/analytics/topics/{slug}
Studio analytics policy topic by slug · Public
GET /api/v1/studio/availability/topics
Studio Instant & Live policy topics (optional q) · Public
GET /api/v1/studio/availability/topics/{slug}
Studio Instant & Live policy topic by slug · Public
GET /api/v1/studio/connect
GET studio · connect · Talent
POST /api/v1/studio/connect
POST studio · connect · Talent
GET /api/v1/studio/decline-reasons
GET studio · decline-reasons · Talent
GET /api/v1/studio/earnings
Talent wallet + history (optional q) · Talent
GET /api/v1/studio/earnings/topics
Studio earnings policy topics (optional q) · Public
GET /api/v1/studio/earnings/topics/{slug}
Studio earnings policy topic by slug · Public
POST /api/v1/studio/feed
POST studio · feed · Talent
GET /api/v1/studio/feed/topics
Studio follower-feed policy topics (optional q) · Public
GET /api/v1/studio/feed/topics/{slug}
Studio follower-feed policy topic by slug · Public
POST /api/v1/studio/instant
POST studio · instant · Talent
POST /api/v1/studio/intro
POST studio · intro · Talent
DELETE /api/v1/studio/live-slots
DELETE studio · live-slots · Talent
GET /api/v1/studio/live-slots
Studio live slots (optional q) · Talent
POST /api/v1/studio/live-slots
POST studio · live-slots · Talent
GET /api/v1/studio/merch
Studio merch drops (optional q) · Talent
POST /api/v1/studio/merch
Publish a talent merch drop · Talent
PATCH /api/v1/studio/merch/{publicId}
Show or hide a studio merch drop · Talent
GET /api/v1/studio/merch/topics
Studio merch store policy topics (optional q) · Public
GET /api/v1/studio/merch/topics/{slug}
Studio merch store policy topic by slug · Public
GET /api/v1/studio/notifications/topics
Studio notification policy topics (optional q) · Public
GET /api/v1/studio/notifications/topics/{slug}
Studio notification policy topic by slug · Public
POST /api/v1/studio/payouts
Request a transfer (FIFO, KYC/Connect gated) · Talent
POST /api/v1/studio/photo
POST studio · photo · Talent
GET /api/v1/studio/profile-videos
GET studio · profile-videos · Talent
POST /api/v1/studio/profile-videos
POST studio · profile-videos · Talent
GET /api/v1/studio/requests
Studio request queue (optional q) · Talent
GET /api/v1/studio/requests/{publicId}
GET studio · requests · :publicId · Talent
POST /api/v1/studio/requests/{publicId}/accept-live
POST studio · requests · :publicId · accept-live · Talent
POST /api/v1/studio/requests/{publicId}/complete-live
POST studio · requests · :publicId · complete-live · Talent
POST /api/v1/studio/requests/{publicId}/decline
POST studio · requests · :publicId · decline · Talent
POST /api/v1/studio/requests/{publicId}/fulfill
Deliver a recorded Kumir (uploadId or multipart) · Talent
GET /api/v1/studio/requests/topics
Studio request-queue policy topics (optional q) · Public
GET /api/v1/studio/requests/topics/{slug}
Studio request-queue policy topic by slug · Public
GET /api/v1/studio/samples
Studio sample videos (optional q) · Talent
POST /api/v1/studio/samples
POST studio · samples · Talent
DELETE /api/v1/studio/samples/{id}
DELETE studio · samples · :id · Talent
GET /api/v1/studio/samples/topics
Studio sample-reel policy topics (optional q) · Public
GET /api/v1/studio/samples/topics/{slug}
Studio sample-reel policy topic by slug · Public
GET /api/v1/studio/settings
GET studio · settings · Talent
POST /api/v1/studio/settings
POST studio · settings · Talent
GET /api/v1/studio/settings/topics
Studio settings policy topics (optional q) · Public
GET /api/v1/studio/settings/topics/{slug}
Studio settings policy topic by slug · Public
GET /api/v1/studio/tax-docs
GET studio · tax-docs · Talent
GET /api/v1/studio/vip
Studio VIP members (optional q) · Talent
GET /api/v1/studio/vip/topics
Studio VIP membership policy topics (optional q) · Public
GET /api/v1/studio/vip/topics/{slug}
Studio VIP membership policy topic by slug · Public
talent
team
telemetry
unsubscribe
uploads
POST /api/v1/uploads
Start a resumable video upload session · Bearer
DELETE /api/v1/uploads/{uploadId}
DELETE uploads · :uploadId · Bearer
GET /api/v1/uploads/{uploadId}
GET uploads · :uploadId · Bearer
PUT /api/v1/uploads/{uploadId}/chunks/{index}
Upload one chunk (idempotent index) · Bearer
POST /api/v1/uploads/{uploadId}/complete
Finish upload, validate, enqueue processing · Bearer