{"openapi":"3.1.1","jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","info":{"title":"Altss Public Profile Reader","version":"1.4.0","description":"Anonymous organization-name search, individual public summaries and a read-only batch of one to five named slugs. No registration, key, token or payment is required. The sandbox returns fictional fixtures only. Breaking response-shape changes require a new URL major version. Within v1, existing fields retain their types and meaning. Changes that would invalidate a response against the v1 contract belong in a new major version. Catalog values and their own version or update dates can change within that contract without a transport-version change. No published public descriptive endpoint is currently deprecated or scheduled for removal. Before retiring a supported endpoint, publish a migration notice and replacement, signal deprecation with the Deprecation header (RFC 9745), and use Sunset (RFC 8594) only when an actual withdrawal date has been announced. Supported aliases are not silently redirected to a different major version."},"servers":[{"url":"https://altss.com/api/v1","description":"Production: published public summaries"},{"url":"https://altss.com/api/v1/sandbox","description":"Sandbox: fictional fixtures, no production queries; search Example or read example-capital-01"}],"security":[],"x-altss-access":{"authentication":"none","registrationRequired":false,"credentialsAccepted":false,"oauthScopes":[],"description":"Anyone may use these bounded public reads without an account, key, token or payment. Permission entries describe available operations, not OAuth scopes or paid entitlements. Do not send credentials or customer data.","permissions":[{"operationId":"searchPublicProfiles","method":"GET","path":"/public/profiles","readOnly":true,"data":"published-public-profile-summary"},{"operationId":"readPublicProfile","method":"GET","path":"/public/profiles/{slug}","readOnly":true,"data":"published-public-profile-summary"},{"operationId":"readPublicProfileBatch","method":"POST","path":"/public/profile-batch","readOnly":true,"data":"published-public-profile-summary"},{"operationId":"batchReadPublicProfiles","method":"POST","path":"/public/batch","readOnly":true,"data":"published-public-profile-summary"}],"limits":{"batchMaxItems":5},"excluded":["private-records","contact-enrichment","account-operations","record-writes","paid-task-execution","bulk-export"],"documentation":"https://altss.com/auth.md","openapi":"https://altss.com/api/v1/public/openapi.json"},"x-altss-versioning":{"policy":"https://altss.com/api-policy.md","strategy":"url-major-version","currentMajor":"1","deprecated":false,"sunset":null,"breakingChanges":"Breaking response-shape changes require a new URL major version. Within v1, existing fields retain their types and meaning. Changes that would invalidate a response against the v1 contract belong in a new major version. Catalog values and their own version or update dates can change within that contract without a transport-version change.","deprecation":"No published public descriptive endpoint is currently deprecated or scheduled for removal. Before retiring a supported endpoint, publish a migration notice and replacement, signal deprecation with the Deprecation header (RFC 9745), and use Sunset (RFC 8594) only when an actual withdrawal date has been announced. Supported aliases are not silently redirected to a different major version."},"externalDocs":{"url":"https://altss.com/auth.md","description":"Executable anonymous search and batch walkthrough"},"paths":{"/public/profiles":{"servers":[{"url":"https://altss.com/api/v1","description":"Published public profile summaries; root aliases do not apply."},{"url":"https://altss.com/api/v1/sandbox","description":"Deterministic fictional sandbox fixtures. Same profile read contract, no production queries. Altss-Environment: sandbox."}],"get":{"operationId":"searchPublicProfiles","summary":"Search published profile names","description":"Anonymous, bounded reads of published summaries with canonical citations. No contacts, private records, account operations, writes, paid tasks or bulk export. Results are private/no-store; no conditional 304 is offered for these reads. GET also supports bodyless HEAD. Pages contain 1–5 matches within one maximum ten-result window. nextCursor is opaque and bound to the query and current results; a changed window returns STALE_CURSOR. No total corpus count or full-inventory traversal is available.","security":[],"parameters":[{"name":"query","in":"query","required":true,"description":"Organization name containing a letter or digit. Unknown or duplicate parameters are rejected.","schema":{"type":"string","minLength":2,"maxLength":120},"example":"Daimler Truck"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":5,"default":5}},{"name":"cursor","in":"query","required":false,"description":"Use nextCursor verbatim with the same query. Restart when stale.","schema":{"type":"string","maxLength":256}}],"responses":{"200":{"description":"A bounded page, including an empty result when no name matches.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProfileSearch"}}}},"400":{"description":"Invalid or ambiguous request, invalid cursor, or stale result window.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"403":{"description":"Unapproved host or Origin.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"405":{"description":"Method not supported; consult Allow.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}},"Allow":{"schema":{"type":"string","const":"GET, HEAD"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"429":{"description":"Shared instance budget (120/60 seconds or four concurrent admitted requests) exceeded. One batch may read up to five profiles. Back off before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"503":{"description":"Temporary upstream failure, never an empty successful record.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}},"Retry-After":{"schema":{"type":"integer","const":30}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}}}}},"/public/profiles/{slug}":{"servers":[{"url":"https://altss.com/api/v1","description":"Published public profile summaries; root aliases do not apply."},{"url":"https://altss.com/api/v1/sandbox","description":"Deterministic fictional sandbox fixtures. Same profile read contract, no production queries. Altss-Environment: sandbox."}],"get":{"operationId":"readPublicProfile","summary":"Read one published profile summary","description":"Anonymous, bounded reads of published summaries with canonical citations. No contacts, private records, account operations, writes, paid tasks or bulk export. Results are private/no-store; no conditional 304 is offered for these reads. GET also supports bodyless HEAD. Known aliases resolve to the published canonical URL. pageUpdatedAt means page modification, not field verification. Missing fields remain unknown.","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[a-z0-9-]+$"},"example":"daimler-truck-ag"}],"responses":{"200":{"description":"A limited public summary and its canonical citation.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProfileRead"}}}},"400":{"description":"Invalid or ambiguous request, invalid cursor, or stale result window.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"403":{"description":"Unapproved host or Origin.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"404":{"description":"No published profile for this slug.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"405":{"description":"Method not supported; consult Allow.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}},"Allow":{"schema":{"type":"string","const":"GET, HEAD"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"429":{"description":"Shared instance budget (120/60 seconds or four concurrent admitted requests) exceeded. One batch may read up to five profiles. Back off before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"503":{"description":"Temporary upstream failure, never an empty successful record.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}},"Retry-After":{"schema":{"type":"integer","const":30}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}}}}},"/public/profile-batch":{"servers":[{"url":"https://altss.com/api/v1","description":"Published public profile summaries; root aliases do not apply."},{"url":"https://altss.com/api/v1/sandbox","description":"Deterministic fictional sandbox fixtures. Same profile read contract, no production queries. Altss-Environment: sandbox."}],"post":{"operationId":"readPublicProfileBatch","summary":"Batch read up to five explicitly named public profiles","description":"Anonymous, bounded reads of published summaries with canonical citations. No contacts, private records, account operations, writes, paid tasks or bulk export. Results are private/no-store; no conditional 304 is offered for these reads. Use POST with a JSON object containing one to five unique slugs. GET and HEAD are not supported on this path. POST is a read-only batch, not a mutation or background job. Inspect each result's status (200, 404 or 503). Optional replay keys coalesce retries for 120 seconds on the same instance, with a maximum 128 entries. A different payload with the same live key returns 409. Temporary-failure batches are not retained. This is not durable or global exactly-once delivery.","security":[],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Optional public read replay key; never use a credential. Same key and payload may replay within this instance's 120-second retention window.","schema":{"type":"string","minLength":16,"maxLength":128,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"requestBody":{"required":true,"description":"16 KiB body limit and two-second read deadline. Readers wait at most eight seconds for data; individual profile fetches and retries cancel with that deadline.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["slugs"],"properties":{"slugs":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[a-z0-9-]+$"},"minItems":1,"maxItems":5,"uniqueItems":true}}},"example":{"slugs":["daimler-truck-ag"]}}}},"responses":{"200":{"description":"Per-profile read outcomes; 200 here does not imply every item was found.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}},"Idempotency-Replayed":{"schema":{"type":"boolean"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProfileBatch"}}}},"400":{"description":"Invalid or ambiguous request body, slug list, query parameter or replay key.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"403":{"description":"Unapproved host or Origin.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"405":{"description":"Method not supported; consult Allow.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}},"Allow":{"schema":{"type":"string","const":"POST"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"408":{"description":"Body read deadline exceeded.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"409":{"description":"Replay key was used for a different payload.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"413":{"description":"Body exceeds 16 KiB.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"415":{"description":"Use application/json.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"429":{"description":"Shared instance budget (120/60 seconds or four concurrent admitted requests) exceeded. One batch may read up to five profiles. Back off before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"503":{"description":"Temporary upstream failure, never an empty successful record.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}},"Retry-After":{"schema":{"type":"integer","const":30}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}}}}},"/public/batch":{"servers":[{"url":"https://altss.com/api/v1","description":"Published public profile summaries; root aliases do not apply."},{"url":"https://altss.com/api/v1/sandbox","description":"Deterministic fictional sandbox fixtures. Same profile read contract, no production queries. Altss-Environment: sandbox."}],"post":{"operationId":"batchReadPublicProfiles","summary":"Batch read up to five explicitly named public profiles","description":"Anonymous, bounded reads of published summaries with canonical citations. No contacts, private records, account operations, writes, paid tasks or bulk export. Results are private/no-store; no conditional 304 is offered for these reads. Use POST with a JSON object containing one to five unique slugs. GET and HEAD are not supported on this path. POST is a read-only batch, not a mutation or background job. Inspect each result's status (200, 404 or 503). Optional replay keys coalesce retries for 120 seconds on the same instance, with a maximum 128 entries. A different payload with the same live key returns 409. Temporary-failure batches are not retained. This is not durable or global exactly-once delivery. Equivalent to /public/profile-batch; both routes share admission and replay state.","security":[],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Optional public read replay key; never use a credential. Same key and payload may replay within this instance's 120-second retention window.","schema":{"type":"string","minLength":16,"maxLength":128,"pattern":"^[A-Za-z0-9_.:-]+$"}}],"requestBody":{"required":true,"description":"16 KiB body limit and two-second read deadline. Readers wait at most eight seconds for data; individual profile fetches and retries cancel with that deadline.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["slugs"],"properties":{"slugs":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[a-z0-9-]+$"},"minItems":1,"maxItems":5,"uniqueItems":true}}},"example":{"slugs":["daimler-truck-ag"]}}}},"responses":{"200":{"description":"Per-profile read outcomes; 200 here does not imply every item was found.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}},"Idempotency-Replayed":{"schema":{"type":"boolean"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProfileBatch"}}}},"400":{"description":"Invalid or ambiguous request body, slug list, query parameter or replay key.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"403":{"description":"Unapproved host or Origin.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"405":{"description":"Method not supported; consult Allow.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}},"Allow":{"schema":{"type":"string","const":"POST"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"408":{"description":"Body read deadline exceeded.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"409":{"description":"Replay key was used for a different payload.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"413":{"description":"Body exceeds 16 KiB.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"415":{"description":"Use application/json.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"429":{"description":"Shared instance budget (120/60 seconds or four concurrent admitted requests) exceeded. One batch may read up to five profiles. Back off before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}},"503":{"description":"Temporary upstream failure, never an empty successful record.","headers":{"Cache-Control":{"schema":{"type":"string","const":"private, no-store, max-age=0"}},"Altss-API-Version":{"schema":{"type":"string","const":"1"}},"Altss-Environment":{"description":"Sandbox returns fictional fixtures and never reads production records.","schema":{"type":"string","enum":["production","sandbox"]}},"RateLimit-Limit":{"description":"120 admitted requests per 60-second instance window. Shared across REST, NLWeb and A2A, not a global or user quota.","schema":{"type":"integer","const":120}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0,"maximum":120}},"RateLimit-Reset":{"description":"Seconds until this instance's window resets.","schema":{"type":"integer","minimum":1,"maximum":60}},"Retry-After":{"schema":{"type":"integer","const":30}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReaderError"}}}}},"tags":["Public profile batch reads"]}}},"components":{"schemas":{"PublicReaderError":{"type":"object","additionalProperties":false,"required":["ok","code","error"],"properties":{"ok":{"type":"boolean","const":false},"code":{"type":"string"},"error":{"type":"string"}}},"PublicProfileRead":{"type":"object","additionalProperties":false,"required":["profile","citations","dateMeaning"],"properties":{"profile":{"type":"object","additionalProperties":false,"required":["slug","name","url"],"properties":{"slug":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[a-z0-9-]+$"},"name":{"type":"string","maxLength":300},"url":{"type":"string","format":"uri"},"type":{"type":"string","maxLength":160},"location":{"type":"string","maxLength":300},"description":{"type":"string","maxLength":6000},"yearFounded":{"type":"integer"},"pageUpdatedAt":{"type":"string"}}},"citations":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["title","url"],"properties":{"title":{"type":"string","maxLength":300},"url":{"type":"string","format":"uri"}}},"maxItems":1,"minItems":1},"dateMeaning":{"type":"string"}}},"PublicProfileSearch":{"type":"object","additionalProperties":false,"required":["query","results","citations","pagination","scope"],"properties":{"query":{"type":"string"},"results":{"type":"array","maxItems":5,"items":{"type":"object","additionalProperties":false,"required":["slug","name","url"],"properties":{"slug":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[a-z0-9-]+$"},"name":{"type":"string","maxLength":300},"url":{"type":"string","format":"uri"},"type":{"type":"string","maxLength":160},"location":{"type":"string","maxLength":300}}}},"citations":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["title","url"],"properties":{"title":{"type":"string","maxLength":300},"url":{"type":"string","format":"uri"}}},"maxItems":5},"pagination":{"type":"object","additionalProperties":false,"required":["limit","returned","hasMore","nextCursor","windowLimit"],"properties":{"limit":{"type":"integer","minimum":1,"maximum":5},"returned":{"type":"integer","minimum":0,"maximum":5},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"],"maxLength":256},"windowLimit":{"type":"integer","const":10}}},"scope":{"type":"string"}}},"PublicProfileBatchInput":{"type":"object","additionalProperties":false,"required":["slugs"],"properties":{"slugs":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[a-z0-9-]+$"},"minItems":1,"maxItems":5,"uniqueItems":true}}},"PublicProfileBatch":{"type":"object","additionalProperties":false,"required":["results","scope"],"properties":{"results":{"type":"array","minItems":1,"maxItems":5,"items":{"oneOf":[{"type":"object","additionalProperties":false,"required":["requestedSlug","status","profile","citations","dateMeaning"],"properties":{"requestedSlug":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[a-z0-9-]+$"},"status":{"type":"integer","const":200},"profile":{"type":"object","additionalProperties":false,"required":["slug","name","url"],"properties":{"slug":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[a-z0-9-]+$"},"name":{"type":"string","maxLength":300},"url":{"type":"string","format":"uri"},"type":{"type":"string","maxLength":160},"location":{"type":"string","maxLength":300},"description":{"type":"string","maxLength":6000},"yearFounded":{"type":"integer"},"pageUpdatedAt":{"type":"string"}}},"citations":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["title","url"],"properties":{"title":{"type":"string","maxLength":300},"url":{"type":"string","format":"uri"}}},"maxItems":1,"minItems":1},"dateMeaning":{"type":"string"}}},{"type":"object","additionalProperties":false,"required":["requestedSlug","status","code"],"properties":{"requestedSlug":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[a-z0-9-]+$"},"status":{"type":"integer","enum":[404,503]},"code":{"type":"string","enum":["PROFILE_NOT_FOUND","RESOURCE_UNAVAILABLE"]}}}]}},"scope":{"type":"string"}}}}}}