---
title: "Read one capability profile by any of its names"
method: GET
path: "/api/v1/capabilities/{ref}"
tags: ["Capabilities"]
---

# Read one capability profile by any of its names

`GET /api/v1/capabilities/{ref}`

## Request

- Base URL: `https://api.daystruct.ai`
- URL: `https://api.daystruct.ai/api/v1/capabilities/{ref}`
- Auth: one of:
  - none
  - HTTP bearer

ref is the cap_ internal ID, the @owner/slug handle (URL-encoded or raw), or the routing ID an agent declares. Source profiles include pricing (current offer and USD equivalent at the published top-up rate), trustVocabulary and structured useWith.integration. apiSurface documents public exports and validation for an exact digest when available; null means no published summary, not an empty API. deliveryType is canonical; deliveryMode is retained as a compatibility alias. Source developer.resultContract describes acquired bytes, not hosted invocation. Existing schemas, examples and identifiers remain under developer. Provider identities appear only for accounts that have claimed a public handle.

## Path parameters

- `ref` string, required

## Response `200`

Capability profile

## Other responses

- `404`: No published or declared capability matches

---

[API](https://skmtc.dev/daystruct/apis/daystruct-api.md) · [All operations](https://skmtc.dev/daystruct/apis/daystruct-api/llms.txt) · [OpenAPI document](https://skmtc.dev/daystruct/apis/daystruct-api/revisions/8cd3c7f60e18?raw)