Get one public launch by stable ID or slug.
GET /api/v1/catalog/launches/{launchReference}. Get one public launch by stable ID or slug.
Request
GET /api/v1/catalog/launches/{launchReference}
The schema permits anonymous access.
Parameters
| Name | In | Type | Required | Constraints | Description |
|---|---|---|---|---|---|
launchReference | path | string | Yes | min length: 1; max length: 100; pattern: ^[a-z0-9][a-z0-9_-]*$ | — |
X-Request-Id | header | string | No | min length: 8; max length: 128; pattern: ^[A-Za-z0-9._:-]+$ | Optional client correlation identifier. The server always generates a separate authoritative request ID and retains a valid supplied value only as secondary audit correlation metadata. |
cURL
Set LAUNCH_REFERENCE to the path and required query values before running this example. URL-encode path values as needed.
curl --fail-with-body --silent --show-error \
--request GET \
--url "https://launch-api.supanova.app/api/v1/catalog/launches/${LAUNCH_REFERENCE}"Responses
200
Public launch detail.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Type: object.
Additional fields are not allowed.
400
Invalid launch reference. Also: VALIDATION_FAILED.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
404
Launch not found.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
429
The caller exceeded an IP or principal request budget.
| Header | Type | Description |
|---|---|---|
Retry-After | integer | Whole seconds to wait before retrying a rate-limited request. |
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
503
A dependency is unavailable or the feature is not enabled on this deployment. Codes: CATALOG_PROJECTION_NOT_CONFIGURED.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
default
Machine-readable API error. The HTTP status identifies the error class.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
Nested schemas
Field links above lead to the complete nested object, array, and variant definitions below. Required fields are scoped to their containing object.
Schema 1
Response 200.item
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
category | string | Yes | allowed: "climate", "consumer", "infrastructure", "rwa" | — |
closesAt | string | Yes | — | — |
id | string | Yes | — | — |
isFeatured | boolean | Yes | — | — |
name | string | Yes | — | — |
offeredAsset | object · Schema 3 | Yes | — | — |
opensAt | string | Yes | — | — |
sale | object · Schema 4 | Yes | — | — |
slug | string | Yes | — | — |
stats | object · Schema 5 | Yes | — | — |
status | string | Yes | allowed: "ended", "graduated", "live", "upcoming" | — |
summary | string | Yes | — | — |
theme | object · Schema 6 | Yes | — | — |
disclosure | string | Yes | — | — |
longDescription | string | Yes | — | — |
milestones | array of object · Schema 7 | Yes | — | — |
tokenAllocations | array of object · Schema 8 | Yes | — | — |
Additional fields are not allowed.
Schema 2
Response 200.meta
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
provenance | object · Schema 9 | Yes | — | — |
schemaVersion | "1" | Yes | — | — |
Additional fields are not allowed.
Schema 3
Response 200.item.offeredAsset
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
id | string | Yes | — | — |
instrumentId | object · Schema 10 | Yes | — | — |
name | string | Yes | — | — |
symbol | string | Yes | — | — |
Additional fields are not allowed.
Schema 4
Response 200.item.sale
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
allocationAmount | string | Yes | — | — |
hardCap | string | Yes | — | — |
maxContribution | string | Yes | — | — |
minContribution | string | Yes | — | — |
paymentAsset | object · Schema 3 | Yes | — | — |
pricePerToken | string | Yes | — | — |
softCap | string | Yes | — | — |
Additional fields are not allowed.
Schema 5
Response 200.item.stats
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
participantCount | integer | Yes | minimum: -9007199254740991; maximum: 9007199254740991 | — |
progressPct | string | Yes | — | — |
raisedAmount | string | Yes | — | — |
Additional fields are not allowed.
Schema 6
Response 200.item.theme
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
accentColor | string | Yes | — | — |
iconText | string | Yes | — | — |
Additional fields are not allowed.
Schema 7
Response 200.item.milestones
Type: array of object.
Array items: object · Schema 11.
Schema 8
Response 200.item.tokenAllocations
Type: array of object.
Array items: object · Schema 12.
Schema 9
Response 200.meta.provenance
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
asOf | string | Yes | — | — |
dataMode | string | Yes | allowed: "projected", "simulated" | — |
disclaimer | string | Yes | — | — |
label | string | Yes | — | — |
networkId | string | Yes | pattern: ^canton:[-_a-zA-Z0-9]{1,32}$ | — |
Additional fields are not allowed.
Schema 10
Response 200.item.offeredAsset.instrumentId
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
admin | string | Yes | — | — |
id | string | Yes | — | — |
Additional fields are not allowed.
Schema 11
Response 200.item.milestones item
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
date | string | Yes | — | — |
label | string | Yes | — | — |
status | string | Yes | allowed: "complete", "planned" | — |
Additional fields are not allowed.
Schema 12
Response 200.item.tokenAllocations item
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
label | string | Yes | — | — |
percentage | string | Yes | — | — |
vesting | string | Yes | — | — |
Additional fields are not allowed.
Source contract
This page is generated from the checked-in customer OpenAPI snapshot. Download JSON, download YAML, or compare the live API reference. Snapshot provenance records the retrieval date and checksum.