Integrate Pixclaim's AI-powered photo licensing into your applications. Browse photos, manage licenses, and automate your workflow via our REST API.
https://pixclaim.com/api/v1All authenticated endpoints require a Bearer token in the Authorization header.
# Register
curl -X POST https://pixclaim.com/api/v1/auth/register \
-H "Content-Type: application/json" \
-d '{"email":"you@example.com","password":"SecurePass1","role":"PHOTOGRAPHER","firstName":"John","lastName":"Doe"}'
# Login
curl -X POST https://pixclaim.com/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"email":"you@example.com","password":"SecurePass1"}'
# Response: { "accessToken": "eyJ...", "refreshToken": "..." }Use the access token for all subsequent requests. Tokens expire after 15 minutes.
# Browse photos
curl https://pixclaim.com/api/v1/photos/browse?page=1&limit=20 \
-H "Authorization: Bearer eyJ..."
# Upload a photo (get presigned URL)
curl -X POST https://pixclaim.com/api/v1/photos/upload \
-H "Authorization: Bearer eyJ..." \
-H "Content-Type: application/json" \
-d '{"filename":"sunset.jpg","mimeType":"image/jpeg","fileSizeBytes":2048000}'
# Refresh expired token
curl -X POST https://pixclaim.com/api/v1/auth/refresh \
-H "Content-Type: application/json" \
-d '{"refreshToken":"..."}'All successful responses are wrapped in a standard envelope:
{
"success": true,
"data": { ... }, // The actual payload
"timestamp": "2026-03-05T12:00:00.000Z"
}
// Error responses:
{
"statusCode": 401,
"message": "Unauthorized",
"error": "Unauthorized"
}Rate Limiting
100 requests / minute per IP
Token Expiry
Access: 15 min, Refresh: 30 days
Content Type
application/json
Upload photos, manage collections, accept licenses, receive payouts.
Browse photos, get AI matches, create license offers, manage lightbox.
API keys, advanced search, webhooks, and all standard features.
Register, login, and manage user sessions with JWT tokens.
https://pixclaim.com/api/v1/auth/auth/registerRegister a new user account (PHOTOGRAPHER or BRAND)/auth/loginLogin with email and password. Returns access + refresh tokens./auth/refreshRefresh an expired access token using a refresh token./auth/forgot-passwordRequest a password reset email./auth/reset-passwordReset password using the token from email./auth/verify-emailVerify email address with token from email./auth/logoutInvalidate current session./auth/meGet the current authenticated user profile.Upload photos, trigger AI analysis, browse available stock photos.
https://pixclaim.com/api/v1/photos/photos/uploadGet a presigned S3 URL for uploading a photo./photos/:id/confirmConfirm upload completed. Triggers AI analysis pipeline./photos/myList your uploaded photos with analysis results./photos/browseBrowse available photos with filters and pagination./photos/:idGet full details of a specific photo./photos/:idDelete one of your photos.Create brand profiles, get AI-matched photos, manage matches.
https://pixclaim.com/api/v1/brands/brands/profileGet your brand profile./brands/profileCreate a brand profile with preferred categories, styles./brands/profileUpdate brand profile./brands/matchesGet AI-matched photos tailored to your brand./brands/matches/:idUpdate match status: VIEWED, INTERESTED, or DISMISSED./brands/photosBrowse all available photos as a brand.Create, negotiate, and manage photo license offers.
https://pixclaim.com/api/v1/licenses/licenses/Create a license offer for a photo (brand to photographer)./licenses/List your licenses./licenses/:idGet license details./licenses/:id/acceptAccept a license offer./licenses/:id/counterSend a counter-offer./licenses/:id/cancelCancel a license offer.View and sign licensing contracts.
https://pixclaim.com/api/v1/contracts/contracts/List your contracts./contracts/:idGet contract details./contracts/:id/signSign a contract.Stripe Connect onboarding, checkout sessions, and payment management.
https://pixclaim.com/api/v1/payments/payments/connect/onboardGet Stripe Connect onboarding URL for receiving payouts./payments/connect/statusGet Stripe Connect account status./payments/create-checkoutCreate a Stripe Checkout session for a license payment./payments/List your payments./payments/:idGet payment details.Manage subscription plans and billing.
https://pixclaim.com/api/v1/subscriptions/subscriptions/plansGet available subscription plans for your role./subscriptions/currentGet your current subscription./subscriptions/checkoutCreate Stripe Checkout session for plan upgrade./subscriptions/cancelCancel subscription at period end.View photographer earnings and payout history.
https://pixclaim.com/api/v1/payouts/payouts/List your payouts./payouts/statsGet earnings statistics./payouts/:idGet payout details.Organize photos into public or private collections.
https://pixclaim.com/api/v1/collections/collections/Create a new collection./collections/myList your collections./collections/public/:slugView a public collection by slug./collections/:idGet collection details./collections/:idUpdate collection title, description, visibility./collections/:idDelete a collection./collections/:id/photosAdd a photo to a collection./collections/:id/photos/:photoIdRemove a photo from a collection.Save photos to your lightbox for later review (brands only).
https://pixclaim.com/api/v1/lightbox/lightbox/Get your lightbox items./lightbox/itemsAdd a photo to your lightbox./lightbox/items/:photoIdRemove a photo from lightbox./lightbox/Clear entire lightbox.Manage your public photographer portfolio.
https://pixclaim.com/api/v1/portfolio/portfolio/manage/settingsGet your portfolio settings./portfolio/manage/settingsUpdate portfolio settings (bio, social links, theme)./portfolio/manage/featuredSet featured photos and their order./portfolio/:usernameView a photographer's public portfolio.Submit model and property releases for photos with people or logos.
https://pixclaim.com/api/v1/releases/releases/modelSubmit a model release./releases/modelList your model releases./releases/propertySubmit a property release./releases/propertyList your property releases.In-app and push notifications management.
https://pixclaim.com/api/v1/notifications/notifications/List your notifications./notifications/:id/readMark a notification as read./notifications/read-allMark all notifications as read./notifications/push-tokenRegister a device push token.Dashboard analytics for photographers and brands.
https://pixclaim.com/api/v1/analytics/analytics/photographer/dashboardPhotographer analytics: views, earnings, top photos./analytics/brand/dashboardBrand analytics: matches, licenses, spending.Register webhook endpoints to receive real-time event notifications.
https://pixclaim.com/api/v1/webhooks/webhooks/endpointsRegister a new webhook endpoint URL./webhooks/endpointsList your registered webhook endpoints./webhooks/endpoints/:idUpdate a webhook endpoint./webhooks/endpoints/:idDelete a webhook endpoint./webhooks/endpoints/:id/deliveriesView delivery history for an endpoint./webhooks/endpoints/:id/testSend a test webhook delivery.Enterprise-tier features: API keys and advanced search.
https://pixclaim.com/api/v1/enterprise/enterprise/api-keysCreate an API key (Enterprise plan required)./enterprise/api-keysList your API keys./enterprise/api-keys/:idRevoke an API key./enterprise/searchAdvanced photo search with enterprise filters.GDPR compliance: data export, account deletion, consent management.
https://pixclaim.com/api/v1/gdpr/gdpr/exportRequest a full data export (Article 20)./gdpr/deletionRequest account deletion (Article 17)./gdpr/requestsView your GDPR request history./gdpr/consentUpdate your consent settings.Register webhook endpoints to receive real-time notifications for these events:
photo.analyzedAI analysis completed for a matched photophoto.availableA new photo matching your brand is availablelicense.createdA new license offer was createdlicense.acceptedA license offer was acceptedlicense.counteredA counter-offer was receivedpayment.completedPayment was processed successfullycontract.signedA contract was signed by both partiesmatch.newNew AI brand match found