API v1 Reference
Welcome to the SeamScape API v1 documentation. Use these endpoints to integrate pattern assets, trigger nesting jobs, and orchestrate production workflows from your own systems.
Each endpoint page covers request contracts, response shapes, and usage recommendations. Start here to familiarise yourself with shared conventions, then jump into the detailed guides below.
Authentication
All requests require a Bearer token. Include your key in the Authorization header:
Authorization: Bearer YOUR_API_KEYAPI keys identify your user account. Organisation access follows your active organisation. Manage your personal API key in Account > API Keys.
To run a request against a specific organisation instead of your active organisation, include X-SeamScape-Organization-Id: ORGANIZATION_ID. The organisation must be one that your user belongs
to. Use X-SeamScape-Organization-Id: personal to explicitly use no organisation context.
Endpoints
POST
/api/v1/patterns/{patternId}
Pattern Endpoint
Retrieve fully parameterised pattern payloads in JSON or DXF.
POST
/api/v1/nest
Nest Endpoint
Submit polygon geometry for automated nesting with streamed progress.
POST
/api/v1/bodydbl
BodyDouble Endpoint
Infer a complete body measurement set from baseline inputs.
Conventions
- All endpoints are served over HTTPS and expect JSON payloads unless otherwise noted.
- Timestamps are ISO 8601 strings in UTC. Numeric values use decimal notation.
- Errors follow the problem+json pattern with
statusandmessagefields. - The Nest endpoint streams NDJSON responses; parse each line separately to capture progress and solutions.