VoidhashDocs
DevelopersHelp centerGuidesAPI reference
Dashboard
Essentials
API overview
Authentication
Event capture
Push device API
Webhooks
Webhook delivery
Webhook events
Projects & keys
Projects
API keys
Audit log
Customers & access
Persons
Products
Perks
Sandbox
Paywalls
Paywalls
Paywall locations
Components
Component registry
Assets
Experiments & flags
Experiments
Feature flags
Analytics & events
Analytics
Analytics alerts
Events
Ingest policy
VoidQL
Tracking domains
Ads
Ads
Ad accounts
Meta measurement
Payments & stores
Payment providers
Payment provider products
Purchase history imports
Payment sources
Webhooks & notifications
Webhooks
Push notifications
Push configurations
Automations
Organization & team
Organizations
Members
Invitations
Billing
Your account
Profile
Session
Notices
Connected apps
Terms of Service
Developer tools
Schema
SDK
List components
Upload a component module
Submit a component's source
Retrieve a component
Update a component
Delete a component
List a component's versions
Retrieve a component version
Update a component version
List component uses

Retrieve a component

Reads one component.

Guide: Components

GET
/api/v1/projects/{projectId}/components/{componentId}

Authorization

AuthorizationBearer <token>

A project secret key: vh_sk_... for production, vh_sk_test_... for test. Keep it on your servers.

In: header

Path parameters

projectId*string

The project's id, proj_.... A secret key works only in the project it belongs to.

componentId*string

The component's id, cmp_....

Examples

curl -X GET "https://api.voidhash.com/api/v1/projects/proj_tz4a98xxat96iws9zmbrgj3a/components/cmp_p4z7c1x9v3b8n2m6q5w0e4r7" \  -H "Authorization: Bearer vh_sk_..."
{  "id": "cmp_p4z7c1x9v3b8n2m6q5w0e4r7",  "projectId": "proj_tz4a98xxat96iws9zmbrgj3a",  "slug": "plan-picker",  "title": "Plan picker",  "category": null,  "latestVersion": {    "id": "cmp_ver_k3m8x2c7v9b4n1q6w5e0r8t2",    "componentId": "cmp_p4z7c1x9v3b8n2m6q5w0e4r7",    "version": 3,    "sourceKind": "rust",    "status": "ready",    "contentHash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",    "panelHash": null,    "byteSize": 58912,    "manifest": {      "id": "project/plan-picker",      "version": "0.1.0",      "title": "Plan picker",      "description": "Selectable plans.",      "icon": {        "kind": "builtin",        "name": "component"      },      "category": "Project",      "keywords": [],      "implementation": {        "kind": "wasm",        "abi": 2      },      "traits": {        "frame": {          "resize": "width"        },        "appearance": {},        "effects": {}      },      "children": {        "kind": "none"      },      "props": [        {          "name": "plans",          "type": {            "kind": "list",            "of": {              "kind": "product"            }          },          "default": []        },        {          "name": "accent",          "type": {            "kind": "color"          },          "default": "#7c3aed"        }      ],      "events": [        {          "name": "selected",          "payload": [            {              "name": "productId",              "type": {                "kind": "string"              }            }          ]        }      ],      "previewStates": [        "default"      ],      "capabilities": [        "commerce"      ],      "panel": false,      "fallback": "placeholder",      "defaultSize": {        "width": "fill",        "height": "hug"      }    },    "isDeprecated": false,    "deprecatedAt": null,    "warnings": [],    "conformance": {      "hasPassed": true,      "checks": [        {          "name": "module",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "manifest",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "imports",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "exports",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "lifecycle",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "values",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "tree",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "determinism",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "events",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "timers",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "layout",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "actions",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "frames",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "memory",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "golden",          "status": "skip",          "errors": [],          "warnings": []        }      ]    },    "createdBy": "user_k3m8q1z6v9c2x5b7n4w0e8r1",    "createdAt": "2026-03-04T16:20:00.000Z",    "builtAt": "2026-03-04T16:21:12.000Z"  },  "latestReadyVersion": {    "id": "cmp_ver_k3m8x2c7v9b4n1q6w5e0r8t2",    "componentId": "cmp_p4z7c1x9v3b8n2m6q5w0e4r7",    "version": 3,    "sourceKind": "rust",    "status": "ready",    "contentHash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",    "panelHash": null,    "byteSize": 58912,    "manifest": {      "id": "project/plan-picker",      "version": "0.1.0",      "title": "Plan picker",      "description": "Selectable plans.",      "icon": {        "kind": "builtin",        "name": "component"      },      "category": "Project",      "keywords": [],      "implementation": {        "kind": "wasm",        "abi": 2      },      "traits": {        "frame": {          "resize": "width"        },        "appearance": {},        "effects": {}      },      "children": {        "kind": "none"      },      "props": [        {          "name": "plans",          "type": {            "kind": "list",            "of": {              "kind": "product"            }          },          "default": []        },        {          "name": "accent",          "type": {            "kind": "color"          },          "default": "#7c3aed"        }      ],      "events": [        {          "name": "selected",          "payload": [            {              "name": "productId",              "type": {                "kind": "string"              }            }          ]        }      ],      "previewStates": [        "default"      ],      "capabilities": [        "commerce"      ],      "panel": false,      "fallback": "placeholder",      "defaultSize": {        "width": "fill",        "height": "hug"      }    },    "isDeprecated": false,    "deprecatedAt": null,    "warnings": [],    "conformance": {      "hasPassed": true,      "checks": [        {          "name": "module",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "manifest",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "imports",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "exports",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "lifecycle",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "values",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "tree",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "determinism",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "events",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "timers",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "layout",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "actions",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "frames",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "memory",          "status": "pass",          "errors": [],          "warnings": []        },        {          "name": "golden",          "status": "skip",          "errors": [],          "warnings": []        }      ]    },    "createdBy": "user_k3m8q1z6v9c2x5b7n4w0e8r1",    "createdAt": "2026-03-04T16:20:00.000Z",    "builtAt": "2026-03-04T16:21:12.000Z"  },  "createdAt": "2026-02-25T11:00:00.000Z",  "updatedAt": "2026-03-04T16:21:12.000Z"}
{  "error": {    "type": "invalid_request",    "code": "string",    "message": "string",    "param": "string"  }}
{  "error": {    "type": "unauthenticated",    "code": "invalid_api_key",    "message": "This secret key is not valid."  }}
{  "error": {    "type": "permission_denied",    "code": "permission_denied",    "message": "Insufficient permissions."  }}

{  "error": {    "type": "not_found",    "code": "component_not_found",    "message": "This project has no component cmp_p4z7c1x9v3b8n2m6q5w0e4r7.",    "param": "componentId"  }}

{  "error": {    "type": "internal",    "code": "internal_error",    "message": "Something went wrong on our side. Try again, and contact support with the Request-Id header if it keeps failing."  }}

Response body

application/json

application/json

application/json

application/json

application/json

application/json

Errors

StatustypecodeWhen
404not_foundcomponent_not_found—

It can also fail with the errors every operation shares, such as unauthenticated; see Errors.

More in Components

  • List components GET
  • Upload a component module POST
  • Submit a component's source POST
  • Update a component PATCH
  • Delete a component DELETE
  • List a component's versions GET
  • Retrieve a component version GET
  • Update a component version PATCH
  • List component uses GET

Something wrong or missing on this page? Tell us by email or on Discord.

PreviousSubmit a component's sourceNextUpdate a component

On this page

AuthorizationPath parametersExamplesResponse bodyErrorsMore in Components