---
raw: true
search:
  tags:
    - Teams
    - GET
seo:
  description: >-
    Read-only metadata for one Space in the current family of a… Reference for
    the GET /v1/teams/{teamId}/external-access/{spaceId} endpoint in the
    Spacefast API.
sidebar:
  label: Read a Space's external access
  badge: GET
title: Read a Space's external access
type: openapi-operation
---
Read-only metadata for one Space in the current family of a parent on an Enterprise or Internal plan. Requires parent admin authority and Space read access. Returns at most 100 links, passwords and people per section, with explicit truncation. Does not return sharing URLs, password proofs, connector credentials or private account identities.

`GET /v1/teams/{teamId}/external-access/{spaceId}`

**Responses**

- `200` — Response for status 200
- `default` — Problem details (RFC 9457). Any 4xx/5xx response is one \`application/problem+json\` document.

Response example, 200:

```json
{
  "$schema": "http://example.com",
  "data": {
    "space": {
      "id": "string",
      "slug": "string",
      "title": "string",
      "liveUrl": "http://example.com",
      "team": {
        "id": "string",
        "name": "string",
        "slug": "string",
        "parentTeamId": "string"
      },
      "publicAccess": {
        "kind": "public",
        "opensAt": "string"
      },
      "searchIndexing": "on",
      "links": {
        "count": 0,
        "uses": 0,
        "lastUsedAt": "string",
        "nextExpiry": "string"
      },
      "passwords": 0,
      "people": 0,
      "pendingPeople": 0,
      "identityAudiences": 0,
      "services": {
        "available": true,
        "roles": [
          {
            "role": "string",
            "connector": "string",
            "context": "team",
            "bound": true,
            "serving": true
          }
        ]
      }
    },
    "publicGrants": [
      {
        "grant": {
          "name": "string",
          "audience": {
            "kind": "public"
          },
          "resources": {
            "include": [
              "string"
            ],
            "exclude": []
          },
          "capabilities": [
            "page.view"
          ],
          "constraints": {},
          "target": {
            "kind": "live"
          },
          "id": "string",
          "source": {
            "kind": "config",
            "reference": "string"
          }
        },
        "generation": 1,
        "status": "scheduled",
        "sourceExplanation": {
          "editable": true,
          "label": "string",
          "detail": "string"
        },
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z"
      }
    ],
    "links": [
      {
        "id": "string",
        "spaceId": "string",
        "grantId": "string",
        "revision": 1,
        "name": "string",
        "landingPath": "string",
        "resources": {
          "include": [
            "string"
          ],
          "exclude": []
        },
        "capabilities": [
          "page.view"
        ],
        "constraints": {
          "notBefore": "2019-08-24T14:15:22Z",
          "expiresAt": "2019-08-24T14:15:22Z",
          "maxUses": 1,
          "requireVerifiedEmail": true,
          "network": {
            "ipCidrs": [
              "string"
            ],
            "countries": [
              "st"
            ],
            "excludedCountries": [
              "st"
            ],
            "excludedUserAgentSubstrings": [
              "string"
            ]
          },
          "frameOrigin": "string"
        },
        "target": {
          "kind": "live"
        },
        "createdBy": "string",
        "openCount": 0,
        "lastUsedAt": "2019-08-24T14:15:22Z",
        "revokedAt": "2019-08-24T14:15:22Z",
        "createdAt": "2019-08-24T14:15:22Z",
        "active": true
      }
    ],
    "passwords": [
      {
        "id": "string",
        "grant": {
          "grant": {
            "name": "string",
            "audience": {
              "kind": "public"
            },
            "resources": {
              "include": [
                "string"
              ],
              "exclude": []
            },
            "capabilities": [
              "page.view"
            ],
            "constraints": {},
            "target": {
              "kind": "live"
            },
            "id": "string",
            "source": {
              "kind": "config",
              "reference": "string"
            }
          },
          "generation": 1,
          "status": "scheduled",
          "sourceExplanation": {
            "editable": true,
            "label": "string",
            "detail": "string"
          },
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z"
        },
        "rotatedAt": "2019-08-24T14:15:22Z",
        "lastUsedAt": "2019-08-24T14:15:22Z",
        "revokedAt": "2019-08-24T14:15:22Z",
        "active": true
      }
    ],
    "people": [
      {
        "id": "string",
        "spaceId": "string",
        "displayName": "string",
        "email": "user@example.com",
        "status": "pending",
        "grants": [
          {
            "id": "string",
            "scope": "string",
            "role": "viewer",
            "target": {
              "kind": "live"
            },
            "createdAt": "2019-08-24T14:15:22Z",
            "revokedAt": "2019-08-24T14:15:22Z"
          }
        ],
        "invitedBy": "string",
        "inviteExpiresAt": "2019-08-24T14:15:22Z",
        "acceptedAt": "2019-08-24T14:15:22Z",
        "revokedAt": "2019-08-24T14:15:22Z",
        "createdAt": "2019-08-24T14:15:22Z"
      }
    ],
    "truncated": {
      "links": true,
      "passwords": true,
      "people": true
    }
  }
}
```