# Get an assignment by ID

Source: https://www.supervisible.com/developers/assignments/get-assignments-id

GET /assignments/{assignment_id}



## GET /assignments/{assignment_id}

Fetch a single assignment row. Supports the same expand keys as the list endpoint (user, project, capability, client). Placeholder reservation IDs return 404 because the public API exposes user assignments only.

Base URL: https://app.supervisible.com/api/v1

Required scope: read:assignments

## Operation contract

The definition below includes parameters, request bodies, response schemas, examples and authentication requirements.

```json
{
  "summary": "Get an assignment by ID",
  "description": "Fetch a single assignment row. Supports the same expand keys as the list endpoint (user, project, capability, client). Placeholder reservation IDs return 404 because the public API exposes user assignments only.",
  "tags": [
    "assignments"
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-required-scope": "read:assignments",
  "parameters": [
    {
      "in": "path",
      "name": "assignment_id",
      "required": true,
      "description": "Assignment ID.",
      "schema": {
        "type": "string",
        "description": "UUID"
      }
    },
    {
      "in": "query",
      "name": "expand",
      "required": false,
      "description": "Comma-separated relations. Valid: user, project, capability, client.",
      "schema": {
        "type": "string"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful response",
      "content": {
        "application/json": {
          "example": {
            "data": {}
          }
        }
      }
    },
    "400": {
      "description": "Invalid request"
    },
    "401": {
      "description": "Unauthorized"
    },
    "403": {
      "description": "Missing required scope or current member permission"
    },
    "404": {
      "description": "Not found"
    },
    "409": {
      "description": "Conflict; refresh current state and preview again"
    },
    "429": {
      "description": "Rate limited; honor Retry-After"
    }
  }
}
```

## Referenced definitions

```json
{
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key"
      }
    }
  }
}
```

[Complete OpenAPI specification](https://www.supervisible.com/openapi/public-api-v1.json)