---
title: "By Id"
method: GET
path: "/tw-v2/space/by-id"
tags: ["Space"]
---

# By Id

`GET /tw-v2/space/by-id`

## Request

- Base URL: `https://api.tweetapi.com`
- URL: `https://api.tweetapi.com/tw-v2/space/by-id`
- Auth: API key in header `X-API-Key`

Retrieve detailed information about a platform Space (audio room) by its ID. Returns comprehensive data including title, state, creator, participants, topics, and engagement stats.

## Query parameters

- `spaceId` string, required

## Response `200`

Successful response

- SpaceResponse
  - `data` Space, required
    - `id` string, required
    - `title` string
    - `state` 'Running' | 'Ended' | 'Scheduled' | 'Canceled', required
    - `mediaKey` string
    - `createdAt` integer
    - `scheduledStart` integer, nullable
    - `startedAt` integer, nullable
    - `endedAt` integer, nullable
    - `updatedAt` integer, nullable
    - `creator` User, nullable
      - `id` string, required
      - `username` string, required
      - `name` string
      - `bio` string
      - `location` string, nullable
      - `website` string, uri, nullable
      - `pinnedTweetIds` string[]
      - `avatar` string, uri, nullable
      - `banner` string, uri, nullable
      - `profileImageShape` 'Circle' | 'Square' | 'null', nullable
      - `verified` boolean
      - `isBlueVerified` boolean
      - `verifiedType` string, nullable
      - `verifiedSince` string, date-time, nullable
      - `isIdentityVerified` boolean
      - `isProtected` boolean
      - `possiblySensitive` boolean
      - `profileInterstitialType` string, nullable
      - `withheldInCountries` string[]
      - `professional` object, nullable
      - `businessAccount` object, nullable
      - `creatorSubscriptionsCount` integer
      - `hasHiddenSubscriptions` boolean
      - `highlightsInfo` object, nullable
      - `hasGraduatedAccess` boolean
      - `isProfileTranslatable` boolean
      - `hasCustomTimelines` boolean
      - `isTranslator` boolean
      - `affiliatesHighlightedLabel` object, nullable
      - `defaultProfile` boolean
      - `defaultProfileImage` boolean
      - `followerCount` integer
      - `followingCount` integer
      - `tweetCount` integer
      - `listedCount` integer
      - `mediaCount` integer
      - `favoritesCount` integer
      - `createdAt` string, date-time, nullable
    - `totalLiveListeners` integer
    - `totalReplayWatched` integer
    - `participants` object
    - `isAvailableForReplay` boolean
    - `isAvailableForClipping` boolean
    - `contentType` string
    - `narrowCastSpaceType` integer
    - `conversationControls` integer
    - `disallowJoin` boolean
    - `isEmployeeOnly` boolean
    - `isLocked` boolean
    - `isMuted` boolean
    - `noIncognito` boolean
    - `maxGuestSessions` integer
    - `maxAdminCapacity` integer
    - `topics` object[]
    - `tweetId` string, nullable
    - `mentionedUserIds` string[]

## Other responses

- `400`: The request is invalid. Check the parameters and try again.
- `401`: The TweetAPI key or caller-supplied Twitter authentication token is missing or invalid.
- `403`: The authenticated account is not permitted to perform the operation.
- `404`: The requested resource or route was not found.
- `429`: A plan limit rejected the request. The code field says which one. RATE_LIMITED means the per-minute limit was exceeded; wait for Retry-After. QUOTA_EXHAUSTED means the allowance and prepaid balance are used up. SUBSCRIPTION_INACTIVE means the subscription has expired or is inactive. Retrying won't fix the last two. A 429 without a code is temporary; retry with bounded backoff. This response does not include X-RateLimit headers.
- `500`: The request could not be completed.
- `503`: Request allowance is temporarily unavailable. This request was not processed. Follow Retry-After before trying again; contact support if the error persists.

---

[API](https://skmtc.dev/tweetapi/apis/tweetapi-v2-api-reference.md) · [All operations](https://skmtc.dev/tweetapi/apis/tweetapi-v2-api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/tweetapi/apis/tweetapi-v2-api-reference/revisions/51bc9024013d?raw)