Skip to content
SoundSyncAudio software platform

API reference

Customer and Serial Management API

Current developer customer tables, serial inventory, imports, purchase history and manual access grants.

Use the current developer-scoped serial routes

For new integrations, use /api/developer/serials rather than the deprecated /api/serials table handlers. Account identity, workspace permissions and assigned products determine access. Supplying another developer ID or broadening a filter does not grant their records.

Lists use page, limit, search, dateRange and supported product filters. Serial inventory distinguishes available and redeemed. Purchases additionally accept channel, productIds, resellerId, provider, refundStatus, recordType, dateFrom and dateTo. IDs in historical or external purchase rows are not automatically refundable managed-checkout order IDs.

Generate and import deliberately

Serial generation requires an owned product and current billing eligibility. Prefix and expiry are inventory settings, not proof of a customer purchase. Reseller serial pools belong in Partners > Licenses; ordinary developer generation rejects reseller assignment.

Download the current CSV template before importing. Upload file as multipart data or send the named customers, serials or purchases JSON array. Product mappings must resolve to allowed products. A 207 result contains row errors and successful rows; correct the failures rather than replaying every row. Purchase imports do not collect payment, transfer billing authority or send purchase marketing messages.

SoundSync

Illustrative owned-product serial generation

Generate inventory, not customer ownership
curl --fail-with-body -sS -X POST "$SOUNDSYNC_API_BASE/api/developer/serials/generate" \
  -H "Authorization: Bearer $DEVELOPER_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"productId":123,"quantity":5,"prefix":"DEMO"}'

Access, history and payment are separate

Activate, reactivate, deactivate, suspend, unsuspend and revoke are administrative serial actions. Hiding an order only changes its supported history presentation. Neither action refunds a payment.

Manual grants give the selected customer access to explicit products. Existing-serial assignment and subscription access grants have single-product restrictions. An access grant does not authorize billing; use the separate supported customer-confirmed payment setup when needed. Keep the reason and grant request reference for reconciliation.

Read access-only history without inventing a payment

GET /api/developer/purchases groups related items under purchase_key. An access-only row uses order_type:access_grant, financial_record:false, invoice_available:false and null order_id/order_item_id. Its access_entitlement_id identifies access, not a paid order. display_order_id falls back to a reference such as ACCESS-123. For a product earned from a subscription, it can instead display the original funding order, also returned as original_subscription_order_id. That display-only link does not make this access row refundable or give it an invoice.

Use recordType:access to select these rows; recordType:order and pool select the other supported record kinds. channel:subscription includes subscription history. These filters do not change ownership or expand product permissions. A subscription payment and a product earned from it are distinct history entries, not two charges. Earned subscription products show zero-cost item totals in the funding order currency; their CSV subtotal and final item total are 0, while the financial order total stays blank. Other non-financial access rows leave financial totals blank. Never add access-only rows to sales revenue or treat their display reference as refund authority.

A manual history entry can retain existing access

A standard product grant can record a manual grant even when the customer already has active access. historyRecorded and alreadyHadAccess describe this result; metadata.manualGrantExistingAccess identifies the retained-access history. It preserves the original entitlement, serial and provenance, without another payment, settlement credit or repeated marketing enrollment.

For that history-only order item, remove-access without deleteRecord:true returns 409 MANUAL_GRANT_HISTORY_ONLY. With deleteRecord:true, it hides the manual history and returns recordOnly:true with zero revocations; the original access remains. Manage the original entitlement or serial separately when an authorized access change is intended. Reuse grantRequestId for the same request after an uncertain response, not for a different grant.

Closing one store account is not deleting SoundSync

The developer customer-removal action closes and blocks the customer account at that store and stops supported pending marketing and measurement. Required purchase and financial history remains. Requests for that closed store return CUSTOMER_STORE_CLOSED; the shared SoundSync identity and unrelated stores are not deleted.

Account closure, a refund, unsubscribing and a privacy-erasure request have different effects. For broader privacy requests, contact support@soundsyncsolutions.biz. Existing retention and legal obligations still apply.

Customer details belong to the relevant store

Authorized developers can correct customer names, email and phone and, for a linked customer account, set a password for their own storefront relationship. These edits do not change the shared SoundSync login, another developer storefront, shared verification, or shared account recovery.

A changed store email or password invalidates earlier sessions and reset links issued for that store credential. The customer signs in using the corrected email in that storefront. Store-only sessions cannot manage global account security or use another store; the shared SoundSync account remains the route for platform-wide settings and integrations.

Email corrections update the store marketing contact, supported pending email work and current store contact references, including support, serial and order contact fields. Later marketing activity and imports retain the corrected store details. Customer edits to the shared SoundSync profile update shared contact records without replacing separate store details. Sent email, issued invoices and payment-provider history remain historical records.

First and last names can be cleared independently. Workspace-wide contact editing requires the existing customers.manage permission and all-products scope. Contact corrections do not transfer purchases, rewrite issued invoices, change refund eligibility or clear marketing restrictions. Last Login records sign-in activity, not a support edit.

Read the result of recovery actions

Internal notes are private support records. Activity and plugin-connection reports can contain customer identity and serial diagnostics; never publish them unredacted. Activation reset clears the supported machines and sessions without refunding or granting products.

An access-email action returns an email outcome object plus libraryUrl. HTTP 200 alone does not mean the provider accepted a message: inspect sent, skipped, reason or error. Required sender configuration and the current stored customer identity still apply.

SoundSync

Related customer operations

Refund API

Whole-product/full-order refunds and operation state.

Customer tools

Profile correction, verification and device recovery.

Deprecated serial API

Compatibility-only handlers and their limits.

SoundSync

Requests and responses

GET /api/developer/customers

Search developer-scoped customers

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Request fields
  • query page: integer
  • query limit: integer
  • query search: string
  • query dateRange: string. all, 1d, 1w, 2w, 1m or custom. Legacy YYYY-MM-DD_to_YYYY-MM-DD is supported. Non-custom presets clear stale calendar dates.
  • query dateFrom: string. Inclusive UTC calendar start, not the Eastern accounting month.
  • query dateTo: string. Inclusive UTC calendar end; the SQL upper bound is the next midnight.
  • query productId: integer
Returns
HTTP 200: rows, total, page, pageSize.
Notes
Account permissions and assigned products determine scope; query filters cannot expand it. Purchase identifiers can include external/manual references; they are not all eligible managed-payment refund IDs.
Request, response and error reference

Query and header parameters

[
  {
    "name": "page",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  },
  {
    "name": "limit",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  },
  {
    "name": "search",
    "in": "query",
    "schema": {
      "type": "string"
    },
    "required": false,
    "description": ""
  },
  {
    "name": "dateRange",
    "in": "query",
    "schema": {
      "type": "string"
    },
    "required": false,
    "description": "all, 1d, 1w, 2w, 1m or custom. Legacy YYYY-MM-DD_to_YYYY-MM-DD is supported. Non-custom presets clear stale calendar dates."
  },
  {
    "name": "dateFrom",
    "in": "query",
    "schema": {
      "type": "string",
      "format": "date"
    },
    "required": false,
    "description": "Inclusive UTC calendar start, not the Eastern accounting month."
  },
  {
    "name": "dateTo",
    "in": "query",
    "schema": {
      "type": "string",
      "format": "date"
    },
    "required": false,
    "description": "Inclusive UTC calendar end; the SQL upper bound is the next midnight."
  },
  {
    "name": "productId",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  }
]

No request body fields are read by this operation.

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "integer",
              "string"
            ],
            "minLength": 1
          },
          "customer_id": {
            "type": "integer",
            "minimum": 1
          },
          "email": {
            "type": "string",
            "format": "email"
          },
          "first_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "last_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": "string"
          },
          "email_verification_status": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "total": {
      "type": "integer"
    },
    "page": {
      "type": "integer"
    },
    "pageSize": {
      "type": "integer"
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

GET /api/developer/customers/export

Export authorized customers as CSV

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Request fields
  • query page: integer
  • query limit: integer
  • query search: string
  • query dateRange: string. all, 1d, 1w, 2w, 1m or custom. Legacy YYYY-MM-DD_to_YYYY-MM-DD is supported. Non-custom presets clear stale calendar dates.
  • query dateFrom: string. Inclusive UTC calendar start, not the Eastern accounting month.
  • query dateTo: string. Inclusive UTC calendar end; the SQL upper bound is the next midnight.
  • query productId: integer
  • header Accept: string. Use application/x-ndjson for progress framing, otherwise receive plain CSV.
Returns
HTTP 200: text/csv.
Notes
Exports all matching authorized records from a stable read-only snapshot; page and limit do not restrict the export to the current screen. All three tables accept dateFrom/dateTo. Customer dates use signup/relationship creation; redeemed serials use redemption and available serials creation; purchases use their source event. Custom calendar bounds are inclusive UTC dates, not Eastern billing buckets. Purchases preserve Purchase Record ID, displayed Order ID and Reseller Order ID separately and can expand a grouped record into multiple item rows. completedRecords counts logical source records/groups, not necessarily CSV lines. With NDJSON, accumulate type:chunk csv fields, require type:complete after commit, and discard partial output on type:error or a disconnected stream. An HTTP 200 before completion is not a successful complete export. CSV remains private, no-store.
Request, response and error reference

Query and header parameters

[
  {
    "name": "page",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  },
  {
    "name": "limit",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  },
  {
    "name": "search",
    "in": "query",
    "schema": {
      "type": "string"
    },
    "required": false,
    "description": ""
  },
  {
    "name": "dateRange",
    "in": "query",
    "schema": {
      "type": "string"
    },
    "required": false,
    "description": "all, 1d, 1w, 2w, 1m or custom. Legacy YYYY-MM-DD_to_YYYY-MM-DD is supported. Non-custom presets clear stale calendar dates."
  },
  {
    "name": "dateFrom",
    "in": "query",
    "schema": {
      "type": "string",
      "format": "date"
    },
    "required": false,
    "description": "Inclusive UTC calendar start, not the Eastern accounting month."
  },
  {
    "name": "dateTo",
    "in": "query",
    "schema": {
      "type": "string",
      "format": "date"
    },
    "required": false,
    "description": "Inclusive UTC calendar end; the SQL upper bound is the next midnight."
  },
  {
    "name": "productId",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  },
  {
    "in": "header",
    "name": "Accept",
    "schema": {
      "type": "string",
      "enum": [
        "text/csv",
        "application/x-ndjson"
      ]
    },
    "description": "Use application/x-ndjson for progress framing, otherwise receive plain CSV."
  }
]

No request body fields are read by this operation.

HTTP 200 response (text/csv)

{
  "type": "string",
  "format": "binary"
}

HTTP 200 response (application/x-ndjson)

{
  "type": "string",
  "description": "Newline-delimited chunk, complete or error frames. A chunk contains csv, completedRecords and totalRecords. Completion is required before offering the accumulated CSV."
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

GET /api/developer/customers/demo-csv

Download the customers import template

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Returns
HTTP 200: text/csv.
Request, response and error reference

No request body fields are read by this operation.

HTTP 200 response (text/csv)

{
  "type": "string",
  "format": "binary"
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

POST /api/developer/customers/import

Import reviewed customers rows

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Request fields
  • file: string
  • customers: array
  • productMappings: object. Operation-specific extension data; do not put credentials or unnecessary personal information here.
Returns
HTTP 201: success, importedCount, insertedCount, errors.
Notes
Send a CSV file under file or the named JSON row array. Inspect row errors on 207; do not blindly replay already imported rows. Product mappings do not bypass ownership. Customer imports require customers.manage and all-products scope; purchase imports require entitlements.manage and serial imports require serials.manage, with assigned-product checks. Purchase import does not collect payment or transfer provider billing authority and disables purchase marketing/email activity.
Request, response and error reference

Request (application/json or multipart/form-data)

{
  "type": "object",
  "properties": {
    "file": {
      "type": "string",
      "format": "binary"
    },
    "customers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "format": "email"
          },
          "firstName": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          },
          "productId": {
            "type": "integer",
            "minimum": 1
          },
          "productName": {
            "type": "string"
          },
          "serialCode": {
            "type": "string"
          },
          "price": {
            "type": "number"
          },
          "salePrice": {
            "type": "number"
          },
          "date": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "productMappings": {
      "type": "object",
      "additionalProperties": true,
      "description": "Operation-specific extension data; do not put credentials or unnecessary personal information here."
    }
  },
  "additionalProperties": true
}

HTTP 201 response (application/json)

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "importedCount": {
      "type": "integer"
    },
    "insertedCount": {
      "type": "integer"
    },
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Operation-specific extension data; do not put credentials or unnecessary personal information here."
      }
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

GET /api/developer/serials

Search serial inventory and device counts

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Request fields
  • query page: integer
  • query limit: integer
  • query search: string
  • query dateRange: string. all, 1d, 1w, 2w, 1m or custom. Legacy YYYY-MM-DD_to_YYYY-MM-DD is supported. Non-custom presets clear stale calendar dates.
  • query dateFrom: string. Inclusive UTC calendar start, not the Eastern accounting month.
  • query dateTo: string. Inclusive UTC calendar end; the SQL upper bound is the next midnight.
  • query productId: integer
  • query status: string
Returns
HTTP 200: rows, total, page, pageSize.
Notes
Account permissions and assigned products determine scope; query filters cannot expand it. Purchase identifiers can include external/manual references; they are not all eligible managed-payment refund IDs.
Request, response and error reference

Query and header parameters

[
  {
    "name": "page",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  },
  {
    "name": "limit",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  },
  {
    "name": "search",
    "in": "query",
    "schema": {
      "type": "string"
    },
    "required": false,
    "description": ""
  },
  {
    "name": "dateRange",
    "in": "query",
    "schema": {
      "type": "string"
    },
    "required": false,
    "description": "all, 1d, 1w, 2w, 1m or custom. Legacy YYYY-MM-DD_to_YYYY-MM-DD is supported. Non-custom presets clear stale calendar dates."
  },
  {
    "name": "dateFrom",
    "in": "query",
    "schema": {
      "type": "string",
      "format": "date"
    },
    "required": false,
    "description": "Inclusive UTC calendar start, not the Eastern accounting month."
  },
  {
    "name": "dateTo",
    "in": "query",
    "schema": {
      "type": "string",
      "format": "date"
    },
    "required": false,
    "description": "Inclusive UTC calendar end; the SQL upper bound is the next midnight."
  },
  {
    "name": "productId",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  },
  {
    "name": "status",
    "in": "query",
    "schema": {
      "type": "string",
      "enum": [
        "available",
        "redeemed"
      ]
    },
    "required": false,
    "description": ""
  }
]

No request body fields are read by this operation.

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "integer",
              "string"
            ],
            "minLength": 1
          },
          "serial": {
            "type": "string"
          },
          "product_id": {
            "type": "integer",
            "minimum": 1
          },
          "product": {
            "type": "string"
          },
          "customer_id": {
            "type": [
              "integer",
              "null"
            ]
          },
          "status": {
            "type": "string"
          },
          "redeemed": {
            "type": "boolean"
          },
          "revoked": {
            "type": "boolean"
          },
          "active_activation_count": {
            "type": "integer"
          },
          "max_activations": {
            "type": "integer"
          },
          "remaining_activations": {
            "type": "integer"
          }
        },
        "additionalProperties": true
      }
    },
    "total": {
      "type": "integer"
    },
    "page": {
      "type": "integer"
    },
    "pageSize": {
      "type": "integer"
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

GET /api/developer/serials/export

Export authorized serials as CSV

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Request fields
  • query page: integer
  • query limit: integer
  • query search: string
  • query dateRange: string. all, 1d, 1w, 2w, 1m or custom. Legacy YYYY-MM-DD_to_YYYY-MM-DD is supported. Non-custom presets clear stale calendar dates.
  • query dateFrom: string. Inclusive UTC calendar start, not the Eastern accounting month.
  • query dateTo: string. Inclusive UTC calendar end; the SQL upper bound is the next midnight.
  • query productId: integer
  • query status: string
  • header Accept: string. Use application/x-ndjson for progress framing, otherwise receive plain CSV.
Returns
HTTP 200: text/csv.
Notes
Exports all matching authorized records from a stable read-only snapshot; page and limit do not restrict the export to the current screen. All three tables accept dateFrom/dateTo. Customer dates use signup/relationship creation; redeemed serials use redemption and available serials creation; purchases use their source event. Custom calendar bounds are inclusive UTC dates, not Eastern billing buckets. Purchases preserve Purchase Record ID, displayed Order ID and Reseller Order ID separately and can expand a grouped record into multiple item rows. completedRecords counts logical source records/groups, not necessarily CSV lines. With NDJSON, accumulate type:chunk csv fields, require type:complete after commit, and discard partial output on type:error or a disconnected stream. An HTTP 200 before completion is not a successful complete export. CSV remains private, no-store.
Request, response and error reference

Query and header parameters

[
  {
    "name": "page",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  },
  {
    "name": "limit",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  },
  {
    "name": "search",
    "in": "query",
    "schema": {
      "type": "string"
    },
    "required": false,
    "description": ""
  },
  {
    "name": "dateRange",
    "in": "query",
    "schema": {
      "type": "string"
    },
    "required": false,
    "description": "all, 1d, 1w, 2w, 1m or custom. Legacy YYYY-MM-DD_to_YYYY-MM-DD is supported. Non-custom presets clear stale calendar dates."
  },
  {
    "name": "dateFrom",
    "in": "query",
    "schema": {
      "type": "string",
      "format": "date"
    },
    "required": false,
    "description": "Inclusive UTC calendar start, not the Eastern accounting month."
  },
  {
    "name": "dateTo",
    "in": "query",
    "schema": {
      "type": "string",
      "format": "date"
    },
    "required": false,
    "description": "Inclusive UTC calendar end; the SQL upper bound is the next midnight."
  },
  {
    "name": "productId",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  },
  {
    "name": "status",
    "in": "query",
    "schema": {
      "type": "string",
      "enum": [
        "available",
        "redeemed"
      ]
    },
    "required": false,
    "description": ""
  },
  {
    "in": "header",
    "name": "Accept",
    "schema": {
      "type": "string",
      "enum": [
        "text/csv",
        "application/x-ndjson"
      ]
    },
    "description": "Use application/x-ndjson for progress framing, otherwise receive plain CSV."
  }
]

No request body fields are read by this operation.

HTTP 200 response (text/csv)

{
  "type": "string",
  "format": "binary"
}

HTTP 200 response (application/x-ndjson)

{
  "type": "string",
  "description": "Newline-delimited chunk, complete or error frames. A chunk contains csv, completedRecords and totalRecords. Completion is required before offering the accumulated CSV."
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

GET /api/developer/serials/demo-csv

Download the serials import template

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Returns
HTTP 200: text/csv.
Request, response and error reference

No request body fields are read by this operation.

HTTP 200 response (text/csv)

{
  "type": "string",
  "format": "binary"
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

POST /api/developer/serials/import

Import reviewed serials rows

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Request fields
  • file: string
  • serials: array
  • productMappings: object. Operation-specific extension data; do not put credentials or unnecessary personal information here.
Returns
HTTP 201: success, importedCount, insertedCount, errors.
Notes
Send a CSV file under file or the named JSON row array. Inspect row errors on 207; do not blindly replay already imported rows. Product mappings do not bypass ownership. Customer imports require customers.manage and all-products scope; purchase imports require entitlements.manage and serial imports require serials.manage, with assigned-product checks. Purchase import does not collect payment or transfer provider billing authority and disables purchase marketing/email activity.
Request, response and error reference

Request (application/json or multipart/form-data)

{
  "type": "object",
  "properties": {
    "file": {
      "type": "string",
      "format": "binary"
    },
    "serials": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "format": "email"
          },
          "firstName": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          },
          "productId": {
            "type": "integer",
            "minimum": 1
          },
          "productName": {
            "type": "string"
          },
          "serialCode": {
            "type": "string"
          },
          "price": {
            "type": "number"
          },
          "salePrice": {
            "type": "number"
          },
          "date": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "productMappings": {
      "type": "object",
      "additionalProperties": true,
      "description": "Operation-specific extension data; do not put credentials or unnecessary personal information here."
    }
  },
  "additionalProperties": true
}

HTTP 201 response (application/json)

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "importedCount": {
      "type": "integer"
    },
    "insertedCount": {
      "type": "integer"
    },
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Operation-specific extension data; do not put credentials or unnecessary personal information here."
      }
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

GET /api/developer/purchases

Search grouped purchase and access history

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Request fields
  • query page: integer
  • query limit: integer
  • query search: string
  • query dateRange: string. all, 1d, 1w, 2w, 1m or custom. Legacy YYYY-MM-DD_to_YYYY-MM-DD is supported. Non-custom presets clear stale calendar dates.
  • query dateFrom: string. Inclusive UTC calendar start, not the Eastern accounting month.
  • query dateTo: string. Inclusive UTC calendar end; the SQL upper bound is the next midnight.
  • query productId: integer
  • query channel: value
  • query productIds: string
  • query resellerId: string
  • query provider: value
  • query refundStatus: value
  • query recordType: value
Returns
HTTP 200: rows, total, page, pageSize, canRefund.
Notes
Account permissions and assigned products determine scope; query filters cannot expand it. Purchase rows group items by purchase_key. Access-only rows have order_type:access_grant, financial_record:false, invoice_available:false and null order_id/order_item_id. display_order_id falls back to ACCESS-<entitlement ID>; an earned subscription product can instead display the funding order, with original_subscription_order_id as a separate reference and zero-cost item totals. Neither display value makes the access row a payment, invoice or refundable order. channel:subscription includes subscription history; recordType:access selects access-only rows. canRefund is a caller capability, not per-row eligibility. Purchase identifiers can also include external/manual references; use the refund preview for an eligible managed-payment order. For external reseller estimates, feeBps is 0: no SoundSync checkout percentage applies. Provider costs and applicable service/redemption charges are separate, not estimated here. recordedAllocation preserves an original unfunded allocation; recordedAdjustmentCents reconciles its net against the currently resolved price/split and recorded collaborator amount, not a new fee or payment. Managed-sale developer allocation fields are before separately billed account charges, not a final payout. receipt_promotions contains deduplicated saved promotion names and codes from accepted order/item/provider snapshots, not the campaign current name. item_promotions retains multiple saved purchase-option deal snapshots; coupon_code and item_sale_name remain compatibility fields. Non-financial access rows return no receipt promotions. This private response is no-store; do not treat displayed discounts as current offer availability.
Request, response and error reference

Query and header parameters

[
  {
    "name": "page",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  },
  {
    "name": "limit",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  },
  {
    "name": "search",
    "in": "query",
    "schema": {
      "type": "string"
    },
    "required": false,
    "description": ""
  },
  {
    "name": "dateRange",
    "in": "query",
    "schema": {
      "type": "string"
    },
    "required": false,
    "description": "all, 1d, 1w, 2w, 1m or custom. Legacy YYYY-MM-DD_to_YYYY-MM-DD is supported. Non-custom presets clear stale calendar dates."
  },
  {
    "name": "dateFrom",
    "in": "query",
    "schema": {
      "type": "string",
      "format": "date"
    },
    "required": false,
    "description": "Inclusive UTC calendar start, not the Eastern accounting month."
  },
  {
    "name": "dateTo",
    "in": "query",
    "schema": {
      "type": "string",
      "format": "date"
    },
    "required": false,
    "description": "Inclusive UTC calendar end; the SQL upper bound is the next midnight."
  },
  {
    "name": "productId",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  },
  {
    "name": "channel",
    "in": "query",
    "schema": {
      "enum": [
        "all",
        "direct",
        "marketplace",
        "reseller",
        "manual",
        "import",
        "free",
        "subscription",
        "other"
      ]
    },
    "required": false,
    "description": ""
  },
  {
    "name": "productIds",
    "in": "query",
    "schema": {
      "type": "string"
    },
    "required": false,
    "description": ""
  },
  {
    "name": "resellerId",
    "in": "query",
    "schema": {
      "type": "string"
    },
    "required": false,
    "description": ""
  },
  {
    "name": "provider",
    "in": "query",
    "schema": {
      "enum": [
        "all",
        "stripe",
        "paypal",
        "other",
        "unknown"
      ]
    },
    "required": false,
    "description": ""
  },
  {
    "name": "refundStatus",
    "in": "query",
    "schema": {
      "enum": [
        "all",
        "none",
        "partial",
        "full",
        "unknown"
      ]
    },
    "required": false,
    "description": ""
  },
  {
    "name": "recordType",
    "in": "query",
    "schema": {
      "enum": [
        "all",
        "order",
        "pool",
        "access"
      ]
    },
    "required": false,
    "description": ""
  }
]

No request body fields are read by this operation.

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "order_id": {
            "type": [
              "integer",
              "string",
              "null"
            ],
            "minLength": 1
          },
          "order_item_id": {
            "type": [
              "integer",
              "string",
              "null"
            ],
            "minLength": 1
          },
          "product_id": {
            "type": "integer",
            "minimum": 1
          },
          "product": {
            "type": "string"
          },
          "customer_id": {
            "type": "integer",
            "minimum": 1
          },
          "status": {
            "type": "string"
          },
          "invoice_available": {
            "type": "boolean"
          },
          "financial_record": {
            "type": "boolean"
          },
          "order_type": {
            "type": "string"
          },
          "purchase_channel": {
            "type": "string"
          },
          "access_entitlement_id": {
            "type": [
              "integer",
              "string"
            ],
            "minLength": 1
          },
          "entitlement_id": {
            "type": [
              "integer",
              "string",
              "null"
            ],
            "minLength": 1
          },
          "entitlement_state": {
            "type": [
              "string",
              "null"
            ]
          },
          "display_order_id": {
            "type": "string"
          },
          "original_subscription_order_id": {
            "type": [
              "integer",
              "string",
              "null"
            ],
            "minLength": 1
          },
          "currency": {
            "type": "string"
          },
          "item_subtotal_cents": {
            "type": "integer"
          },
          "final_total_cents": {
            "type": "integer"
          },
          "total_cents": {
            "type": "integer"
          },
          "purchase_key": {
            "type": "string"
          },
          "occurred_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "created_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "reseller_estimate": {
            "type": "object",
            "properties": {
              "feeBps": {
                "const": 0
              },
              "saleCents": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "rate": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "resellerCents": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "feeCents": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "payoutCents": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "partnerShareCents": {
                "type": "integer"
              },
              "recordedAllocation": {
                "type": "boolean"
              },
              "recordedAdjustmentCents": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "refunded": {
                "type": "boolean"
              },
              "currentTerms": {
                "type": "boolean"
              },
              "unavailableReason": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "additionalProperties": true
          },
          "metadata": {
            "type": "object",
            "additionalProperties": true,
            "description": "Operation-specific extension data; do not put credentials or unnecessary personal information here."
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "order_id": {
                  "type": [
                    "integer",
                    "string",
                    "null"
                  ],
                  "minLength": 1
                },
                "order_item_id": {
                  "type": [
                    "integer",
                    "string",
                    "null"
                  ],
                  "minLength": 1
                },
                "product_id": {
                  "type": "integer",
                  "minimum": 1
                },
                "product": {
                  "type": "string"
                },
                "customer_id": {
                  "type": "integer",
                  "minimum": 1
                },
                "status": {
                  "type": "string"
                },
                "invoice_available": {
                  "type": "boolean"
                },
                "financial_record": {
                  "type": "boolean"
                },
                "order_type": {
                  "type": "string"
                },
                "purchase_channel": {
                  "type": "string"
                },
                "access_entitlement_id": {
                  "type": [
                    "integer",
                    "string"
                  ],
                  "minLength": 1
                },
                "entitlement_id": {
                  "type": [
                    "integer",
                    "string",
                    "null"
                  ],
                  "minLength": 1
                },
                "entitlement_state": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "display_order_id": {
                  "type": "string"
                },
                "original_subscription_order_id": {
                  "type": [
                    "integer",
                    "string",
                    "null"
                  ],
                  "minLength": 1
                },
                "currency": {
                  "type": "string"
                },
                "item_subtotal_cents": {
                  "type": "integer"
                },
                "final_total_cents": {
                  "type": "integer"
                },
                "total_cents": {
                  "type": "integer"
                },
                "purchase_key": {
                  "type": "string"
                },
                "occurred_at": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date-time"
                },
                "created_at": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date-time"
                },
                "reseller_estimate": {
                  "type": "object",
                  "properties": {
                    "feeBps": {
                      "const": 0
                    },
                    "saleCents": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "rate": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "resellerCents": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "feeCents": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "payoutCents": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "partnerShareCents": {
                      "type": "integer"
                    },
                    "recordedAllocation": {
                      "type": "boolean"
                    },
                    "recordedAdjustmentCents": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "refunded": {
                      "type": "boolean"
                    },
                    "currentTerms": {
                      "type": "boolean"
                    },
                    "unavailableReason": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "additionalProperties": true
                },
                "metadata": {
                  "type": "object",
                  "additionalProperties": true,
                  "description": "Operation-specific extension data; do not put credentials or unnecessary personal information here."
                }
              },
              "additionalProperties": true
            }
          },
          "coupon_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "item_promotion": {
            "type": "object",
            "properties": {
              "title": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "couponCode": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": true
          },
          "item_promotions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "title": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "couponCode": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "additionalProperties": true
            }
          },
          "item_sale_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "receipt_promotions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "code": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "additionalProperties": true
            }
          }
        },
        "additionalProperties": true
      }
    },
    "total": {
      "type": "integer"
    },
    "page": {
      "type": "integer"
    },
    "pageSize": {
      "type": "integer"
    },
    "canRefund": {
      "type": "boolean"
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

GET /api/developer/purchases/export

Export authorized purchases as CSV

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Request fields
  • query page: integer
  • query limit: integer
  • query search: string
  • query dateRange: string. all, 1d, 1w, 2w, 1m or custom. Legacy YYYY-MM-DD_to_YYYY-MM-DD is supported. Non-custom presets clear stale calendar dates.
  • query dateFrom: string. Inclusive UTC calendar start, not the Eastern accounting month.
  • query dateTo: string. Inclusive UTC calendar end; the SQL upper bound is the next midnight.
  • query productId: integer
  • query channel: value
  • query productIds: string
  • query resellerId: string
  • query provider: value
  • query refundStatus: value
  • query recordType: value
  • header Accept: string. Use application/x-ndjson for progress framing, otherwise receive plain CSV.
Returns
HTTP 200: text/csv.
Notes
Exports all matching authorized records from a stable read-only snapshot; page and limit do not restrict the export to the current screen. All three tables accept dateFrom/dateTo. Customer dates use signup/relationship creation; redeemed serials use redemption and available serials creation; purchases use their source event. Custom calendar bounds are inclusive UTC dates, not Eastern billing buckets. Purchases preserve Purchase Record ID, displayed Order ID and Reseller Order ID separately and can expand a grouped record into multiple item rows. completedRecords counts logical source records/groups, not necessarily CSV lines. With NDJSON, accumulate type:chunk csv fields, require type:complete after commit, and discard partial output on type:error or a disconnected stream. An HTTP 200 before completion is not a successful complete export. CSV remains private, no-store.
Request, response and error reference

Query and header parameters

[
  {
    "name": "page",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  },
  {
    "name": "limit",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  },
  {
    "name": "search",
    "in": "query",
    "schema": {
      "type": "string"
    },
    "required": false,
    "description": ""
  },
  {
    "name": "dateRange",
    "in": "query",
    "schema": {
      "type": "string"
    },
    "required": false,
    "description": "all, 1d, 1w, 2w, 1m or custom. Legacy YYYY-MM-DD_to_YYYY-MM-DD is supported. Non-custom presets clear stale calendar dates."
  },
  {
    "name": "dateFrom",
    "in": "query",
    "schema": {
      "type": "string",
      "format": "date"
    },
    "required": false,
    "description": "Inclusive UTC calendar start, not the Eastern accounting month."
  },
  {
    "name": "dateTo",
    "in": "query",
    "schema": {
      "type": "string",
      "format": "date"
    },
    "required": false,
    "description": "Inclusive UTC calendar end; the SQL upper bound is the next midnight."
  },
  {
    "name": "productId",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  },
  {
    "name": "channel",
    "in": "query",
    "schema": {
      "enum": [
        "all",
        "direct",
        "marketplace",
        "reseller",
        "manual",
        "import",
        "free",
        "subscription",
        "other"
      ]
    },
    "required": false,
    "description": ""
  },
  {
    "name": "productIds",
    "in": "query",
    "schema": {
      "type": "string"
    },
    "required": false,
    "description": ""
  },
  {
    "name": "resellerId",
    "in": "query",
    "schema": {
      "type": "string"
    },
    "required": false,
    "description": ""
  },
  {
    "name": "provider",
    "in": "query",
    "schema": {
      "enum": [
        "all",
        "stripe",
        "paypal",
        "other",
        "unknown"
      ]
    },
    "required": false,
    "description": ""
  },
  {
    "name": "refundStatus",
    "in": "query",
    "schema": {
      "enum": [
        "all",
        "none",
        "partial",
        "full",
        "unknown"
      ]
    },
    "required": false,
    "description": ""
  },
  {
    "name": "recordType",
    "in": "query",
    "schema": {
      "enum": [
        "all",
        "order",
        "pool",
        "access"
      ]
    },
    "required": false,
    "description": ""
  },
  {
    "in": "header",
    "name": "Accept",
    "schema": {
      "type": "string",
      "enum": [
        "text/csv",
        "application/x-ndjson"
      ]
    },
    "description": "Use application/x-ndjson for progress framing, otherwise receive plain CSV."
  }
]

No request body fields are read by this operation.

HTTP 200 response (text/csv)

{
  "type": "string",
  "format": "binary"
}

HTTP 200 response (application/x-ndjson)

{
  "type": "string",
  "description": "Newline-delimited chunk, complete or error frames. A chunk contains csv, completedRecords and totalRecords. Completion is required before offering the accumulated CSV."
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

GET /api/developer/purchases/demo-csv

Download the purchases import template

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Returns
HTTP 200: text/csv.
Request, response and error reference

No request body fields are read by this operation.

HTTP 200 response (text/csv)

{
  "type": "string",
  "format": "binary"
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

POST /api/developer/purchases/import

Import reviewed purchases rows

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Request fields
  • file: string
  • purchases: array
  • productMappings: object. Operation-specific extension data; do not put credentials or unnecessary personal information here.
Returns
HTTP 201: success, importedCount, insertedCount, errors.
Notes
Send a CSV file under file or the named JSON row array. Inspect row errors on 207; do not blindly replay already imported rows. Product mappings do not bypass ownership. Customer imports require customers.manage and all-products scope; purchase imports require entitlements.manage and serial imports require serials.manage, with assigned-product checks. Purchase import does not collect payment or transfer provider billing authority and disables purchase marketing/email activity.
Request, response and error reference

Request (application/json or multipart/form-data)

{
  "type": "object",
  "properties": {
    "file": {
      "type": "string",
      "format": "binary"
    },
    "purchases": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "format": "email"
          },
          "firstName": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          },
          "productId": {
            "type": "integer",
            "minimum": 1
          },
          "productName": {
            "type": "string"
          },
          "serialCode": {
            "type": "string"
          },
          "price": {
            "type": "number"
          },
          "salePrice": {
            "type": "number"
          },
          "date": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "productMappings": {
      "type": "object",
      "additionalProperties": true,
      "description": "Operation-specific extension data; do not put credentials or unnecessary personal information here."
    }
  },
  "additionalProperties": true
}

HTTP 201 response (application/json)

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "importedCount": {
      "type": "integer"
    },
    "insertedCount": {
      "type": "integer"
    },
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Operation-specific extension data; do not put credentials or unnecessary personal information here."
      }
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

DELETE /api/developer/customers/{customerId}

Close a customer account at this store

Auth
Account Bearer session token
Scope
The developer customer relationship and all-products workspace scope. Mutations require the operation-specific manage permission; a linked login credential is never changed by a contact edit.
Request fields
  • confirm: boolean
  • confirmation: string
  • reason: string
Returns
HTTP 200: ok, alreadyRemoved, already_removed, storeAccountClosed, customer_id, developer_customer_id, message.
Notes
Requires customers.manage, all-products workspace scope and confirm:true or confirmation:"yes". Marks this store relationship blocked/closed, stops its pending marketing and measurement, and retains required purchase/financial history. Store access returns CUSTOMER_STORE_CLOSED. This is not global account deletion, a refund, closure of another store or automatic erasure of every record. Review the account-closure and privacy-request guides.
Request, response and error reference

Request (application/json)

{
  "type": "object",
  "properties": {
    "confirm": {
      "type": "boolean"
    },
    "confirmation": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    }
  },
  "additionalProperties": true,
  "anyOf": [
    {
      "properties": {
        "confirm": {
          "const": true
        }
      },
      "required": [
        "confirm"
      ]
    },
    {
      "properties": {
        "confirmation": {
          "type": "string",
          "pattern": "^\\s*[Yy][Ee][Ss]\\s*$"
        }
      },
      "required": [
        "confirmation"
      ]
    }
  ]
}

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "alreadyRemoved": {
      "type": "boolean"
    },
    "already_removed": {
      "type": "boolean"
    },
    "storeAccountClosed": {
      "type": "boolean"
    },
    "customer_id": {
      "type": "integer",
      "minimum": 1
    },
    "developer_customer_id": {
      "type": [
        "integer",
        "string",
        "null"
      ]
    },
    "message": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

GET /api/developer/serials/available-by-product

Group available serials by product and promotion

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Request fields
  • query page: integer
  • query limit: integer
  • query search: string
  • query dateRange: string. all, 1d, 1w, 2w, 1m or custom. Legacy YYYY-MM-DD_to_YYYY-MM-DD is supported. Non-custom presets clear stale calendar dates.
  • query dateFrom: string. Inclusive UTC calendar start, not the Eastern accounting month.
  • query dateTo: string. Inclusive UTC calendar end; the SQL upper bound is the next midnight.
  • query productId: integer
Returns
HTTP 200: products, promos, rows, total, page, pageSize.
Request, response and error reference

Query and header parameters

[
  {
    "name": "page",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  },
  {
    "name": "limit",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  },
  {
    "name": "search",
    "in": "query",
    "schema": {
      "type": "string"
    },
    "required": false,
    "description": ""
  },
  {
    "name": "dateRange",
    "in": "query",
    "schema": {
      "type": "string"
    },
    "required": false,
    "description": "all, 1d, 1w, 2w, 1m or custom. Legacy YYYY-MM-DD_to_YYYY-MM-DD is supported. Non-custom presets clear stale calendar dates."
  },
  {
    "name": "dateFrom",
    "in": "query",
    "schema": {
      "type": "string",
      "format": "date"
    },
    "required": false,
    "description": "Inclusive UTC calendar start, not the Eastern accounting month."
  },
  {
    "name": "dateTo",
    "in": "query",
    "schema": {
      "type": "string",
      "format": "date"
    },
    "required": false,
    "description": "Inclusive UTC calendar end; the SQL upper bound is the next midnight."
  },
  {
    "name": "productId",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1
    },
    "required": false,
    "description": ""
  }
]

No request body fields are read by this operation.

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "products": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Operation-specific extension data; do not put credentials or unnecessary personal information here."
      }
    },
    "promos": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Operation-specific extension data; do not put credentials or unnecessary personal information here."
      }
    },
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "integer",
              "string"
            ],
            "minLength": 1
          },
          "serial": {
            "type": "string"
          },
          "product_id": {
            "type": "integer",
            "minimum": 1
          },
          "product": {
            "type": "string"
          },
          "customer_id": {
            "type": [
              "integer",
              "null"
            ]
          },
          "status": {
            "type": "string"
          },
          "redeemed": {
            "type": "boolean"
          },
          "revoked": {
            "type": "boolean"
          },
          "active_activation_count": {
            "type": "integer"
          },
          "max_activations": {
            "type": "integer"
          },
          "remaining_activations": {
            "type": "integer"
          }
        },
        "additionalProperties": true
      }
    },
    "total": {
      "type": "integer"
    },
    "page": {
      "type": "integer"
    },
    "pageSize": {
      "type": "integer"
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

GET /api/developer/serials/resellers

List eligible relationship and legacy reseller references

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Returns
HTTP 200: resellers.
Request, response and error reference

No request body fields are read by this operation.

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "resellers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "integer",
              "string"
            ],
            "minLength": 1
          },
          "name": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "relationship_id": {
            "type": "integer",
            "minimum": 1
          },
          "developer_share_bps": {
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "additionalProperties": true
      }
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

POST /api/developer/serials/generate

Generate unique serials for an owned product

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Request fields
  • productId: integer
  • product_id: integer
  • quantity: integer (required)
  • prefix: string
  • expiresAt: string,null
  • promoPrice: number
  • promoStart: string,null
  • promoExpires: string,null
  • activeFrom: string,null
  • activeTo: string,null
  • batchTag: string
  • notes: string
Returns
HTTP 201: message, count, product, serials.
Notes
product_id and corresponding snake_case date/price aliases remain accepted. Use Partners > Licenses for reseller serial pools; reseller assignment on this route returns PARTNER_POOL_REQUIRED. Existing billing and product-scope checks apply.
Request, response and error reference

Request (application/json)

{
  "type": "object",
  "properties": {
    "productId": {
      "type": "integer",
      "minimum": 1
    },
    "product_id": {
      "type": "integer",
      "minimum": 1
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "prefix": {
      "type": "string"
    },
    "expiresAt": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "promoPrice": {
      "type": "number"
    },
    "promoStart": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "promoExpires": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "activeFrom": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "activeTo": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "batchTag": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    }
  },
  "required": [
    "quantity"
  ],
  "additionalProperties": true,
  "anyOf": [
    {
      "required": [
        "productId"
      ]
    },
    {
      "required": [
        "product_id"
      ]
    }
  ]
}

HTTP 201 response (application/json)

{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    },
    "count": {
      "type": "integer"
    },
    "product": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "minimum": 1
        },
        "name": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "serials": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "integer",
              "string"
            ],
            "minLength": 1
          },
          "serial": {
            "type": "string"
          },
          "product_id": {
            "type": "integer",
            "minimum": 1
          },
          "product": {
            "type": "string"
          },
          "customer_id": {
            "type": [
              "integer",
              "null"
            ]
          },
          "status": {
            "type": "string"
          },
          "redeemed": {
            "type": "boolean"
          },
          "revoked": {
            "type": "boolean"
          },
          "active_activation_count": {
            "type": "integer"
          },
          "max_activations": {
            "type": "integer"
          },
          "remaining_activations": {
            "type": "integer"
          }
        },
        "additionalProperties": true
      }
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

POST /api/developer/serials/{serialId}/activate

Apply the activate serial-access action

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Request fields
  • reason: string
  • note: string
Returns
HTTP 200: serial, deactivatedActivations.
Notes
Changes developer-controlled serial access. It is not a provider refund, customer identity transfer or checkout payment. Revocation/suspension/deactivation can affect existing devices.
Request, response and error reference

Request (application/json)

{
  "type": "object",
  "properties": {
    "reason": {
      "type": "string"
    },
    "note": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "serial": {
      "type": "object",
      "properties": {
        "id": {
          "type": [
            "integer",
            "string"
          ],
          "minLength": 1
        },
        "serial": {
          "type": "string"
        },
        "product_id": {
          "type": "integer",
          "minimum": 1
        },
        "product": {
          "type": "string"
        },
        "customer_id": {
          "type": [
            "integer",
            "null"
          ]
        },
        "status": {
          "type": "string"
        },
        "redeemed": {
          "type": "boolean"
        },
        "revoked": {
          "type": "boolean"
        },
        "active_activation_count": {
          "type": "integer"
        },
        "max_activations": {
          "type": "integer"
        },
        "remaining_activations": {
          "type": "integer"
        }
      },
      "additionalProperties": true
    },
    "deactivatedActivations": {
      "type": "integer"
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

POST /api/developer/serials/{serialId}/reactivate

Apply the reactivate serial-access action

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Request fields
  • reason: string
  • note: string
Returns
HTTP 200: serial, deactivatedActivations.
Notes
Changes developer-controlled serial access. It is not a provider refund, customer identity transfer or checkout payment. Revocation/suspension/deactivation can affect existing devices.
Request, response and error reference

Request (application/json)

{
  "type": "object",
  "properties": {
    "reason": {
      "type": "string"
    },
    "note": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "serial": {
      "type": "object",
      "properties": {
        "id": {
          "type": [
            "integer",
            "string"
          ],
          "minLength": 1
        },
        "serial": {
          "type": "string"
        },
        "product_id": {
          "type": "integer",
          "minimum": 1
        },
        "product": {
          "type": "string"
        },
        "customer_id": {
          "type": [
            "integer",
            "null"
          ]
        },
        "status": {
          "type": "string"
        },
        "redeemed": {
          "type": "boolean"
        },
        "revoked": {
          "type": "boolean"
        },
        "active_activation_count": {
          "type": "integer"
        },
        "max_activations": {
          "type": "integer"
        },
        "remaining_activations": {
          "type": "integer"
        }
      },
      "additionalProperties": true
    },
    "deactivatedActivations": {
      "type": "integer"
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

POST /api/developer/serials/{serialId}/deactivate

Apply the deactivate serial-access action

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Request fields
  • reason: string
  • note: string
Returns
HTTP 200: serial, deactivatedActivations.
Notes
Changes developer-controlled serial access. It is not a provider refund, customer identity transfer or checkout payment. Revocation/suspension/deactivation can affect existing devices.
Request, response and error reference

Request (application/json)

{
  "type": "object",
  "properties": {
    "reason": {
      "type": "string"
    },
    "note": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "serial": {
      "type": "object",
      "properties": {
        "id": {
          "type": [
            "integer",
            "string"
          ],
          "minLength": 1
        },
        "serial": {
          "type": "string"
        },
        "product_id": {
          "type": "integer",
          "minimum": 1
        },
        "product": {
          "type": "string"
        },
        "customer_id": {
          "type": [
            "integer",
            "null"
          ]
        },
        "status": {
          "type": "string"
        },
        "redeemed": {
          "type": "boolean"
        },
        "revoked": {
          "type": "boolean"
        },
        "active_activation_count": {
          "type": "integer"
        },
        "max_activations": {
          "type": "integer"
        },
        "remaining_activations": {
          "type": "integer"
        }
      },
      "additionalProperties": true
    },
    "deactivatedActivations": {
      "type": "integer"
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

POST /api/developer/serials/{serialId}/suspend

Apply the suspend serial-access action

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Request fields
  • reason: string
  • note: string
Returns
HTTP 200: serial, deactivatedActivations.
Notes
Changes developer-controlled serial access. It is not a provider refund, customer identity transfer or checkout payment. Revocation/suspension/deactivation can affect existing devices.
Request, response and error reference

Request (application/json)

{
  "type": "object",
  "properties": {
    "reason": {
      "type": "string"
    },
    "note": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "serial": {
      "type": "object",
      "properties": {
        "id": {
          "type": [
            "integer",
            "string"
          ],
          "minLength": 1
        },
        "serial": {
          "type": "string"
        },
        "product_id": {
          "type": "integer",
          "minimum": 1
        },
        "product": {
          "type": "string"
        },
        "customer_id": {
          "type": [
            "integer",
            "null"
          ]
        },
        "status": {
          "type": "string"
        },
        "redeemed": {
          "type": "boolean"
        },
        "revoked": {
          "type": "boolean"
        },
        "active_activation_count": {
          "type": "integer"
        },
        "max_activations": {
          "type": "integer"
        },
        "remaining_activations": {
          "type": "integer"
        }
      },
      "additionalProperties": true
    },
    "deactivatedActivations": {
      "type": "integer"
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

POST /api/developer/serials/{serialId}/unsuspend

Apply the unsuspend serial-access action

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Request fields
  • reason: string
  • note: string
Returns
HTTP 200: serial, deactivatedActivations.
Notes
Changes developer-controlled serial access. It is not a provider refund, customer identity transfer or checkout payment. Revocation/suspension/deactivation can affect existing devices.
Request, response and error reference

Request (application/json)

{
  "type": "object",
  "properties": {
    "reason": {
      "type": "string"
    },
    "note": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "serial": {
      "type": "object",
      "properties": {
        "id": {
          "type": [
            "integer",
            "string"
          ],
          "minLength": 1
        },
        "serial": {
          "type": "string"
        },
        "product_id": {
          "type": "integer",
          "minimum": 1
        },
        "product": {
          "type": "string"
        },
        "customer_id": {
          "type": [
            "integer",
            "null"
          ]
        },
        "status": {
          "type": "string"
        },
        "redeemed": {
          "type": "boolean"
        },
        "revoked": {
          "type": "boolean"
        },
        "active_activation_count": {
          "type": "integer"
        },
        "max_activations": {
          "type": "integer"
        },
        "remaining_activations": {
          "type": "integer"
        }
      },
      "additionalProperties": true
    },
    "deactivatedActivations": {
      "type": "integer"
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

POST /api/developer/serials/{serialId}/revoke

Apply the revoke serial-access action

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Request fields
  • reason: string
  • note: string
Returns
HTTP 200: serial, deactivatedActivations.
Notes
Changes developer-controlled serial access. It is not a provider refund, customer identity transfer or checkout payment. Revocation/suspension/deactivation can affect existing devices.
Request, response and error reference

Request (application/json)

{
  "type": "object",
  "properties": {
    "reason": {
      "type": "string"
    },
    "note": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "serial": {
      "type": "object",
      "properties": {
        "id": {
          "type": [
            "integer",
            "string"
          ],
          "minLength": 1
        },
        "serial": {
          "type": "string"
        },
        "product_id": {
          "type": "integer",
          "minimum": 1
        },
        "product": {
          "type": "string"
        },
        "customer_id": {
          "type": [
            "integer",
            "null"
          ]
        },
        "status": {
          "type": "string"
        },
        "redeemed": {
          "type": "boolean"
        },
        "revoked": {
          "type": "boolean"
        },
        "active_activation_count": {
          "type": "integer"
        },
        "max_activations": {
          "type": "integer"
        },
        "remaining_activations": {
          "type": "integer"
        }
      },
      "additionalProperties": true
    },
    "deactivatedActivations": {
      "type": "integer"
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

POST /api/developer/serials/{serialId}/customer-portal-order/hide

Hide the supported order from customer history

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Request fields
  • reason: string
  • note: string
Returns
HTTP 200: serialId, serial, orderId, customerPortalHidden.
Notes
Changes history presentation, not product ownership or payment/refund state.
Request, response and error reference

Request (application/json)

{
  "type": "object",
  "properties": {
    "reason": {
      "type": "string"
    },
    "note": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "serialId": {
      "type": [
        "integer",
        "string"
      ],
      "minLength": 1
    },
    "serial": {
      "type": "string"
    },
    "orderId": {
      "type": [
        "integer",
        "string"
      ],
      "minLength": 1
    },
    "customerPortalHidden": {
      "type": "boolean"
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

POST /api/developer/serials/{serialId}/customer-portal-order/show

Show the supported order in customer history

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Request fields
  • reason: string
  • note: string
Returns
HTTP 200: serialId, serial, orderId, customerPortalHidden.
Notes
Changes history presentation, not product ownership or payment/refund state.
Request, response and error reference

Request (application/json)

{
  "type": "object",
  "properties": {
    "reason": {
      "type": "string"
    },
    "note": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "serialId": {
      "type": [
        "integer",
        "string"
      ],
      "minLength": 1
    },
    "serial": {
      "type": "string"
    },
    "orderId": {
      "type": [
        "integer",
        "string"
      ],
      "minLength": 1
    },
    "customerPortalHidden": {
      "type": "boolean"
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

GET /api/developer/purchases/filter-options

Read permitted purchase product and reseller filters

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Returns
HTTP 200: products, resellers.
Request, response and error reference

No request body fields are read by this operation.

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "products": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "minimum": 1
          },
          "name": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "resellers": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Operation-specific extension data; do not put credentials or unnecessary personal information here."
      }
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

POST /api/developer/purchases/manual-grant

Grant authorized product access without collecting payment

Auth
Account Bearer session token
Scope
Authenticated account, effective developer workspace, applicable permissions and product ownership. Read the operation notes for legacy or owner-only restrictions.
Request fields
  • productId: integer
  • productIds: array
  • email: string
  • firstName: string
  • lastName: string
  • customerId: integer
  • grantType: string
  • grantRequestId: string
  • reason: string
  • note: string
  • serialId: integer
  • sendProductPurchaseEmails: boolean
  • subscriptionGrantDuration: week | month | three_months | custom | lifetime
  • subscriptionGrantEndDate: string
Returns
HTTP 201: success, grantType, count, createdCount, skippedCount, created, grants, products, purchases, items, entitlements, serials, historyRecorded, alreadyHadAccess.
Notes
Choose explicit products and customer identity. Existing-serial assignment and subscription grants are single-product operations. Reuse grantRequestId only for the same intended grant. A standard product grant can record manual history even when active access already exists; historyRecorded/alreadyHadAccess identify that result. Existing entitlement provenance and serials are retained; this is not a second payment, repeated marketing enrollment or a settlement credit. Subscription grants require subscriptionGrantDuration; custom also requires subscriptionGrantEndDate as YYYY-MM-DD. A timed manual keep-products grant immediately owns the included product snapshot without payment; lifetime grants remain complimentary ongoing access. Future billing requires separate payment setup, preview and customer confirmation. Explicit developer access removal can revoke the manual grant; cancellation or expiry of its subscription does not remove the timed keep-products gift.
Request, response and error reference

Request (application/json)

{
  "type": "object",
  "properties": {
    "productId": {
      "type": "integer",
      "minimum": 1
    },
    "productIds": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 1
      }
    },
    "email": {
      "type": "string",
      "format": "email"
    },
    "firstName": {
      "type": "string"
    },
    "lastName": {
      "type": "string"
    },
    "customerId": {
      "type": "integer",
      "minimum": 1
    },
    "grantType": {
      "type": "string"
    },
    "grantRequestId": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    },
    "note": {
      "type": "string"
    },
    "serialId": {
      "type": "integer",
      "minimum": 1
    },
    "sendProductPurchaseEmails": {
      "type": "boolean"
    },
    "subscriptionGrantDuration": {
      "type": "string",
      "enum": [
        "week",
        "month",
        "three_months",
        "custom",
        "lifetime"
      ]
    },
    "subscriptionGrantEndDate": {
      "type": "string",
      "format": "date"
    }
  },
  "additionalProperties": true
}

HTTP 201 response (application/json)

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "grantType": {
      "type": "string"
    },
    "count": {
      "type": "integer"
    },
    "createdCount": {
      "type": "integer"
    },
    "skippedCount": {
      "type": "integer"
    },
    "created": {
      "type": "boolean"
    },
    "grants": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Operation-specific extension data; do not put credentials or unnecessary personal information here."
      }
    },
    "products": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "minimum": 1
          },
          "name": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "slug": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "shortDescription": {
            "type": [
              "string",
              "null"
            ]
          },
          "price": {
            "type": "number"
          },
          "salePrice": {
            "type": [
              "number",
              "null"
            ]
          },
          "regularPrice": {
            "type": "number"
          },
          "displayPrice": {
            "type": "number"
          },
          "priceDisplay": {
            "type": "string"
          },
          "regularPriceDisplay": {
            "type": "string"
          },
          "salePriceDisplay": {
            "type": [
              "string",
              "null"
            ]
          },
          "isOnSale": {
            "type": "boolean"
          },
          "currency": {
            "type": "string"
          },
          "imageUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "coverImage": {
            "type": [
              "string",
              "null"
            ]
          },
          "developerId": {
            "type": "integer",
            "minimum": 1
          },
          "developerName": {
            "type": "string"
          },
          "developer": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "id": {
                "type": "integer",
                "minimum": 1
              },
              "name": {
                "type": "string"
              },
              "slug": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "profileUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "verified": {
                "type": "boolean"
              }
            },
            "additionalProperties": true
          },
          "productType": {
            "type": "string"
          },
          "productTypes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "url": {
            "type": "string"
          },
          "subscriptionEnabled": {
            "type": "boolean"
          },
          "billingInterval": {
            "type": [
              "string",
              "null"
            ]
          },
          "checkoutEligible": {
            "type": "boolean"
          },
          "capabilities": {
            "type": "object",
            "additionalProperties": true,
            "description": "Operation-specific extension data; do not put credentials or unnecessary personal information here."
          },
          "requiresActivation": {
            "type": "boolean"
          },
          "supportsSerials": {
            "type": "boolean"
          },
          "supportsDownloads": {
            "type": "boolean"
          },
          "marketplaceAsset": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Operation-specific extension data; do not put credentials or unnecessary personal information here."
          }
        },
        "additionalProperties": true
      }
    },
    "purchases": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Operation-specific extension data; do not put credentials or unnecessary personal information here."
      }
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Operation-specific extension data; do not put credentials or unnecessary personal information here."
      }
    },
    "entitlements": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Operation-specific extension data; do not put credentials or unnecessary personal information here."
      }
    },
    "serials": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "integer",
              "string"
            ],
            "minLength": 1
          },
          "serial": {
            "type": "string"
          },
          "product_id": {
            "type": "integer",
            "minimum": 1
          },
          "product": {
            "type": "string"
          },
          "customer_id": {
            "type": [
              "integer",
              "null"
            ]
          },
          "status": {
            "type": "string"
          },
          "redeemed": {
            "type": "boolean"
          },
          "revoked": {
            "type": "boolean"
          },
          "active_activation_count": {
            "type": "integer"
          },
          "max_activations": {
            "type": "integer"
          },
          "remaining_activations": {
            "type": "integer"
          }
        },
        "additionalProperties": true
      }
    },
    "historyRecorded": {
      "type": "boolean"
    },
    "alreadyHadAccess": {
      "type": "boolean"
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

GET /api/developer/customers/{customerId}/activity

Read customer activity

Auth
Account Bearer session token
Scope
customers.view and all-products workspace scope; queries stay developer-scoped.
Request fields
  • query limit: integer
Returns
HTTP 200: events.
Notes
Activity uses camelCase fields; connection and note rows use database-style names. Plugin connections additionally filter fields: customers.view permits customer identity, device_hash and engagement_signal_id; serials.view permits serial_id/serial_code. Opaque failure_reason and metadata require both, otherwise null/{}. Client parameters cannot grant access. Keep permitted diagnostics private. Internal notes are not customer-visible messages. Notes return the latest 100 rows.
Request, response and error reference

Query and header parameters

[
  {
    "name": "limit",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 25
    },
    "required": false,
    "description": ""
  }
]

No request body fields are read by this operation.

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "events": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 1
              },
              {
                "type": "string",
                "pattern": "^[1-9][0-9]*$"
              }
            ],
            "description": "A positive identifier. PostgreSQL bigint fields can be decimal strings; preserve them without lossy numeric conversion."
          },
          "developerId": {
            "type": "integer",
            "minimum": 1
          },
          "actorType": {
            "type": [
              "string",
              "null"
            ]
          },
          "actorUserId": {
            "type": [
              "integer",
              "null"
            ]
          },
          "customerId": {
            "type": [
              "integer",
              "null"
            ]
          },
          "customerEmail": {
            "type": [
              "string",
              "null"
            ]
          },
          "customerName": {
            "type": [
              "string",
              "null"
            ]
          },
          "productId": {
            "type": [
              "integer",
              "null"
            ]
          },
          "productName": {
            "type": [
              "string",
              "null"
            ]
          },
          "serialId": {
            "type": [
              "integer",
              "null"
            ]
          },
          "serialCode": {
            "type": [
              "string",
              "null"
            ]
          },
          "entitlementId": {
            "anyOf": [
              {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 1
                  },
                  {
                    "type": "string",
                    "pattern": "^[1-9][0-9]*$"
                  }
                ],
                "description": "A positive identifier. PostgreSQL bigint fields can be decimal strings; preserve them without lossy numeric conversion."
              },
              {
                "type": "null"
              }
            ]
          },
          "orderId": {
            "anyOf": [
              {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 1
                  },
                  {
                    "type": "string",
                    "pattern": "^[1-9][0-9]*$"
                  }
                ],
                "description": "A positive identifier. PostgreSQL bigint fields can be decimal strings; preserve them without lossy numeric conversion."
              },
              {
                "type": "null"
              }
            ]
          },
          "eventType": {
            "type": "string"
          },
          "severity": {
            "type": "string"
          },
          "message": {
            "type": [
              "string",
              "null"
            ]
          },
          "createdAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "metadata": {
            "type": "object",
            "additionalProperties": true,
            "description": "Operation-specific extension data; do not put credentials or unnecessary personal information here."
          }
        },
        "additionalProperties": true
      }
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

GET /api/developer/customers/{customerId}/plugin-connections

Read customer plugin-connection activity

Auth
Account Bearer session token
Scope
customers.view and all-products workspace scope; queries stay developer-scoped.
Request fields
  • query limit: integer
Returns
HTTP 200: connections.
Notes
Activity uses camelCase fields; connection and note rows use database-style names. Plugin connections additionally filter fields: customers.view permits customer identity, device_hash and engagement_signal_id; serials.view permits serial_id/serial_code. Opaque failure_reason and metadata require both, otherwise null/{}. Client parameters cannot grant access. Keep permitted diagnostics private. Internal notes are not customer-visible messages. Notes return the latest 100 rows.
Request, response and error reference

Query and header parameters

[
  {
    "name": "limit",
    "in": "query",
    "schema": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 25
    },
    "required": false,
    "description": ""
  }
]

No request body fields are read by this operation.

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "connections": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 1
              },
              {
                "type": "string",
                "pattern": "^[1-9][0-9]*$"
              }
            ],
            "description": "A positive identifier. PostgreSQL bigint fields can be decimal strings; preserve them without lossy numeric conversion."
          },
          "developer_id": {
            "type": "integer",
            "minimum": 1
          },
          "customer_id": {
            "type": [
              "integer",
              "null"
            ]
          },
          "product_id": {
            "type": "integer",
            "minimum": 1
          },
          "serial_id": {
            "type": [
              "integer",
              "null"
            ]
          },
          "developer_customer_id": {
            "anyOf": [
              {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 1
                  },
                  {
                    "type": "string",
                    "pattern": "^[1-9][0-9]*$"
                  }
                ],
                "description": "A positive identifier. PostgreSQL bigint fields can be decimal strings; preserve them without lossy numeric conversion."
              },
              {
                "type": "null"
              }
            ]
          },
          "key_id": {
            "anyOf": [
              {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 1
                  },
                  {
                    "type": "string",
                    "pattern": "^[1-9][0-9]*$"
                  }
                ],
                "description": "A positive identifier. PostgreSQL bigint fields can be decimal strings; preserve them without lossy numeric conversion."
              },
              {
                "type": "null"
              }
            ]
          },
          "engagement_signal_id": {
            "anyOf": [
              {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 1
                  },
                  {
                    "type": "string",
                    "pattern": "^[1-9][0-9]*$"
                  }
                ],
                "description": "A positive identifier. PostgreSQL bigint fields can be decimal strings; preserve them without lossy numeric conversion."
              },
              {
                "type": "null"
              }
            ]
          },
          "event_kind": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "plugin_version": {
            "type": [
              "string",
              "null"
            ]
          },
          "environment": {
            "type": [
              "string",
              "null"
            ]
          },
          "device_hash": {
            "type": [
              "string",
              "null"
            ]
          },
          "failure_reason": {
            "type": [
              "string",
              "null"
            ]
          },
          "product_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "customer_email": {
            "type": [
              "string",
              "null"
            ]
          },
          "serial_code": {
            "type": [
              "string",
              "null"
            ]
          },
          "created_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "metadata": {
            "type": "object",
            "additionalProperties": true,
            "description": "Operation-specific extension data; do not put credentials or unnecessary personal information here."
          }
        },
        "additionalProperties": true
      }
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

GET /api/developer/customers/{customerId}/notes

Read internal support notes

Auth
Account Bearer session token
Scope
customers.view and all-products workspace scope; queries stay developer-scoped.
Returns
HTTP 200: notes.
Notes
Activity uses camelCase fields; connection and note rows use database-style names. Plugin connections additionally filter fields: customers.view permits customer identity, device_hash and engagement_signal_id; serials.view permits serial_id/serial_code. Opaque failure_reason and metadata require both, otherwise null/{}. Client parameters cannot grant access. Keep permitted diagnostics private. Internal notes are not customer-visible messages. Notes return the latest 100 rows.
Request, response and error reference

No request body fields are read by this operation.

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "notes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 1
              },
              {
                "type": "string",
                "pattern": "^[1-9][0-9]*$"
              }
            ],
            "description": "A positive identifier. PostgreSQL bigint fields can be decimal strings; preserve them without lossy numeric conversion."
          },
          "developer_id": {
            "type": "integer",
            "minimum": 1
          },
          "customer_id": {
            "type": "integer",
            "minimum": 1
          },
          "author_user_id": {
            "type": [
              "integer",
              "null"
            ]
          },
          "note": {
            "type": "string"
          },
          "created_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "updated_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          }
        },
        "additionalProperties": true
      }
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

POST /api/developer/customers/{customerId}/notes

Add an internal customer support note

Auth
Account Bearer session token
Scope
customers.manage and all-products workspace scope.
Request fields
  • note: string (required)
Returns
HTTP 201: note.
Notes
Does not send the note to the customer. Avoid credentials, full serials and unnecessary sensitive information.
Request, response and error reference

Request (application/json)

{
  "type": "object",
  "properties": {
    "note": {
      "type": "string"
    }
  },
  "required": [
    "note"
  ],
  "additionalProperties": true
}

HTTP 201 response (application/json)

{
  "type": "object",
  "properties": {
    "note": {
      "type": "object",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 1
            },
            {
              "type": "string",
              "pattern": "^[1-9][0-9]*$"
            }
          ],
          "description": "A positive identifier. PostgreSQL bigint fields can be decimal strings; preserve them without lossy numeric conversion."
        },
        "developer_id": {
          "type": "integer",
          "minimum": 1
        },
        "customer_id": {
          "type": "integer",
          "minimum": 1
        },
        "author_user_id": {
          "type": [
            "integer",
            "null"
          ]
        },
        "note": {
          "type": "string"
        },
        "created_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "updated_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        }
      },
      "additionalProperties": true
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

POST /api/developer/customers/{customerId}/reset-activations

Reset eligible customer device activations

Auth
Account Bearer session token
Scope
entitlements.manage and all-products workspace scope.
Request fields
  • productId: integer
Returns
HTTP 200: reset, serialCount, resetCount.
Notes
Read the returned reset counts. A reset is not a refund, a new product grant or permission for recurring billing.
Request, response and error reference

Request (application/json)

{
  "type": "object",
  "properties": {
    "productId": {
      "type": "integer",
      "minimum": 1
    }
  },
  "additionalProperties": true
}

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "reset": {
      "type": "boolean"
    },
    "serialCount": {
      "type": "integer"
    },
    "resetCount": {
      "type": "integer"
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

POST /api/developer/customers/{customerId}/resend-library-email

Send the supported customer access email

Auth
Account Bearer session token
Scope
customers.manage and all-products workspace scope.
Request fields
  • productId: integer
Returns
HTTP 200: email, libraryUrl.
Notes
Uses the stored customer identity, not an arbitrary destination email. This is a transactional access message, not marketing enrollment or proof of inbox delivery.
Request, response and error reference

Request (application/json)

{
  "type": "object",
  "properties": {
    "productId": {
      "type": "integer",
      "minimum": 1
    }
  },
  "additionalProperties": true
}

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "email": {
      "type": "object",
      "properties": {
        "sent": {
          "type": "boolean"
        },
        "skipped": {
          "type": "boolean"
        },
        "reason": {
          "type": "string"
        },
        "error": {
          "type": "string"
        },
        "providerMessageId": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "additionalProperties": true
    },
    "libraryUrl": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

POST /api/developer/customers/{customerId}/resend-activation-email

Send the supported customer access email

Auth
Account Bearer session token
Scope
customers.manage and all-products workspace scope.
Request fields
  • productId: integer
Returns
HTTP 200: email, libraryUrl.
Notes
Uses the stored customer identity, not an arbitrary destination email. This is a transactional access message, not marketing enrollment or proof of inbox delivery.
Request, response and error reference

Request (application/json)

{
  "type": "object",
  "properties": {
    "productId": {
      "type": "integer",
      "minimum": 1
    }
  },
  "additionalProperties": true
}

HTTP 200 response (application/json)

{
  "type": "object",
  "properties": {
    "email": {
      "type": "object",
      "properties": {
        "sent": {
          "type": "boolean"
        },
        "skipped": {
          "type": "boolean"
        },
        "reason": {
          "type": "string"
        },
        "error": {
          "type": "string"
        },
        "providerMessageId": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "additionalProperties": true
    },
    "libraryUrl": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

Documented failures: 400, 401, 403, 404, 409, 500, 503.

Connection diagnostics respect record permissions

Permission to inspect a product integration does not grant access to its customer identities or serial keys. Product connection diagnostics require credentials.view and an assigned product. Customer identity and device-linked fields additionally require customers.view; serial fields require serials.view. Restricted fields are returned as null.

Failure explanations and arbitrary nested metadata can repeat customer or serial details, so they are returned only when both record permissions are present; otherwise the explanation is null and metadata is empty. Customer-specific connection history also requires customers.view and all-products scope. Event kind, status, version, environment and timestamps remain available to permitted diagnostic users.

Permanent gifts and paid subscription ownership

A timed manual keep-products grant gives the customer permanent ownership of the products included when the developer makes that grant, without a payment. That original product snapshot remains owned after subscription cancellation, expiry or incomplete billing setup. Explicit developer access removal can revoke the grant. New products added later are not retroactively included.

A lifetime manual grant instead provides complimentary ongoing subscription access; it is not the timed-grant ownership model or evidence of a paid invoice. Ordinary access-only grants and unpaid checkout trials also do not create paid ownership.

Paid keep-products invoices establish their own product snapshots. Refunding or reversing a paid purchase affects that purchase, not an independent manual ownership grant. Future paid subscription benefits still require the separate billing setup, preview and customer confirmation; a gift is not permission to charge a card.

Saved receipt promotion fields

GET /api/developer/purchases returns receipt_promotions as saved name/code pairs, with item_promotions for multiple accepted purchase-option deals and the supported legacy coupon/name fields. The server deduplicates saved display entries without replacing them with the current campaign name. Non-financial access rows return an empty receipt promotion list. This remains a private, no-store response under the existing purchase and field-level permissions.

Use the current customer API

The dashboard uses /api/developer/customers for customer lists and its /import and /export operations. These routes apply the selected workspace, existing customer permissions and supported product scope. Use the current customer library at /api/library for customer-owned access; a developer customer list is not a customer login or download token.

SoundSync

Retired customer paths

Previous operationCurrent operation
GET /api/customers/list or /api/customers/allGET /api/developer/customers
POST /api/customers/importPOST /api/developer/customers/import
GET /api/customers/exportGET /api/developer/customers/export
GET /api/customers/meGET /api/library with the current customer authentication flow

Retirement does not remove customer records

The old paths return HTTP 410 with LEGACY_CUSTOMER_API_RETIRED, a documentation link and a replacement path. They no longer read customer records or process CSV uploads. Existing customer data, purchases, current dashboard imports/exports and customer-library access are unchanged. Update an older integration to the documented authentication and response contract; this is not a transparent URL-only redirect.

Retired serial read and export views

The old /api/serials list, available, redeemed, export, serials, transactions, customers-list and resellers views return HTTP 410 with LEGACY_SERIAL_VIEW_RETIRED. Use /api/developer/serials and its export route, /api/developer/customers, /api/developer/purchases or the current Partner Hub APIs instead. The retirement response identifies the replacement; old filters and response formats are not carried forward.

Current generation, customer serial redemption, authorized downloads and guarded serial actions remain available. No serial, customer, order or purchase history is deleted by retiring these views.

Read the sale allocation separately from the final payout

A managed purchase receipt shows the original developer allocation before separately billed account charges, where applicable. Actual processing, marketing or redemption usage, the monthly-minimum adjustment and payout costs can be reconciled elsewhere. That allocation is not the final bank payment.

For external purchases, reseller_estimate.feeBps is 0. recordedAllocation identifies a saved unfunded allocation. A recordedAdjustmentCents value reconciles its original net against the currently resolved sale price, reseller split and recorded collaborator amount; it is not a newly charged fee. Missing prices or split terms stay unavailable rather than becoming a confirmed zero.

Read every export frame before saving a completed CSV

GET /api/developer/customers/export, /serials/export and /purchases/export export every matching permitted record, independently of the screen page. All accept dateFrom/dateTo and supported dateRange presets; custom calendar dates use UTC. Purchase exports also retain channel, productIds, resellerId, provider, refundStatus and recordType filters.

Send Accept: application/x-ndjson for progress. Each type:chunk frame contains csv, completedRecords and totalRecords; append csv in order. Wait for type:complete before offering the download. Discard partial output on type:error or disconnect. Plain text/csv remains supported. Purchase Record ID preserves source identity; grouped purchase records can expand into several CSV lines.