# Get one grant

Returns one of the caller’s grants with the client that holds it, the teams it can act in right now, that is its stored team scope intersected with the holder’s live memberships, each scope marked as baseline or elevation with the elevation’s expiry, and the always-allow tool policies on its live hosted MCP sessions. Requires a browser session. A grant belonging to anyone else answers 404.

GET`/v1/me/grants/{grantId}`

## Authorization

`Authorization`Bearer token · headerrequired

\`Authorization: Bearer <token>\` with an API key (\`sfa\_\` prefix), an OAuth access token, a session token, or a Space machine credential (\`sfm\_\` prefix).

### Path parameters

`grantId`stringrequired

min length 1

### Responses

#### 200Response for status 200

`$schema`string<uri>

Canonical JSON Schema URL for this response body. The server also sends it in the \`Link: rel="describedby"\` response header.

`data`objectrequired

Show propertiesHide properties

`id`stringrequired

`name`stringrequired

`kind`stringrequired

Allowed:`agent``app``cli``handoff``api-key``machine`

`clientName`string

`logoUri`string

`status`stringrequired

Allowed:`active``expired``revoked`

`teams`object\[\]required

Show propertiesHide properties

Array of `object`

`teamId`stringrequired

`teamName`stringrequired

`allTeams`booleanrequired

`scopes`object\[\]required

Show propertiesHide properties

Array of `object`

`id`stringrequired

`label`stringrequired

`source`stringrequired

Allowed:`baseline``elevation`

`elevatedUntil`string<date-time>

matches ^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$

`toolPolicies`object\[\]required

Show propertiesHide properties

Array of `object`

`sessionId`stringrequired

`tool`stringrequired

`teamId`stringrequired

`lastUsedAt`string<date-time> | anyrequired

Show propertiesHide properties

Any of:

string<date-time>

`string<date-time>`

any

`any`

`createdAt`string<date-time>required

`expiresAt`string<date-time>required

defaultError. Every 4xx and 5xx response is one RFC 9457 problem document served as \`application/problem+json\`.

`$schema`string<uri>

Canonical JSON Schema URL for this response body. The server also sends it in the \`Link: rel="describedby"\` response header.

`type`stringrequired

URL of the documentation page for this error. Derived from \`code\`.

`title`stringrequired

Human-readable name of the error type. Derived from \`code\`.

`status`integerrequired

HTTP status of the response, repeated in the body.

min -9007199254740991 · max 9007199254740991

`detail`stringrequired

What went wrong in this request.

`code`stringrequired

Stable snake\_case error code. Match on this, not on \`detail\`.

`pointer`string

RFC 6901 JSON Pointer to the request field or batch entry that failed, for example \`/files/37/path\`. Present on validation failures.

`details`object

Machine-readable context keyed by the error code.

`suggestions`string\[\]

Recovery steps safe to show to a person.

`next`string\[\]

Commands or API requests to run next, usable as written.

`requestId`stringrequired

ID of this request, from the \`X-Request-Id\` header or generated. Quote it when contacting support.

## Try it

### Server

Base URLhttps://api.spacefast.comCustom base URLOverrides the selected server when set.

### Authorization

Bearer tokenRemember on this deviceInclude my values in samples

### Parameters

`grantId`path\*

Send

### Request

#### cURL

```bash
curl -X GET "https://api.spacefast.com/v1/me/grants/string" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

#### JavaScript

```javascript
const response = await fetch("https://api.spacefast.com/v1/me/grants/string", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});
```

#### Python

```python
import requests

response = requests.get(
    "https://api.spacefast.com/v1/me/grants/string",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)
```

### Response

#### 200default

```json
{
  "$schema": "http://example.com",
  "data": {
    "id": "string",
    "name": "string",
    "kind": "agent",
    "clientName": "string",
    "logoUri": "string",
    "status": "active",
    "teams": [\
      {\
        "teamId": "string",\
        "teamName": "string"\
      }\
    ],
    "allTeams": true,
    "scopes": [\
      {\
        "id": "string",\
        "label": "string",\
        "source": "baseline",\
        "elevatedUntil": "2019-08-24T14:15:22Z"\
      }\
    ],
    "toolPolicies": [\
      {\
        "sessionId": "string",\
        "tool": "string",\
        "teamId": "string"\
      }\
    ],
    "lastUsedAt": "2019-08-24T14:15:22Z",
    "createdAt": "2019-08-24T14:15:22Z",
    "expiresAt": "2019-08-24T14:15:22Z"
  }
}
```

```json
{
  "$schema": "http://example.com",
  "type": "string",
  "title": "string",
  "status": -9007199254740991,
  "detail": "string",
  "code": "string",
  "pointer": "string",
  "details": {
    "property1": null,
    "property2": null
  },
  "suggestions": [\
    "string"\
  ],
  "next": [\
    "string"\
  ],
  "requestId": "string"
}
```