# Read what the workspace still needs set up

The paperwork between this workspace and the Lenders surface, answered PER CALLER: the workspace's KYC status, the workspace's signature on the current MSA, and whether THIS person has accepted it. A KYC that is submitted but not yet verified already counts as unlocked; in_progress and rejected do not. Any seat.

Access class: `workspace`.

## Endpoint

`GET /v1/workspace/readiness`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| body | query | null | No |
| params | query | object | No |
| query | query | object | No |

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "kycStatus": "string",
    "lendersUnlocked": true,
    "msaSigned": true,
    "msaVersion": "string",
    "unlocked": true,
    "workspace": {
      "agreement": {
        "signedByWorkspace": true,
        "version": "string"
      },
      "kycFields": {
        "authorized_signer_email": "string",
        "authorized_signer_name": "string",
        "authorized_signer_title": "string",
        "dba": "string",
        "entity_type": "string",
        "legal_name": "string",
        "notice_address": "string",
        "notice_email": "string",
        "tax_id_last4": "string"
      },
      "kycMissingFields": [
        "string"
      ],
      "kycStatus": "string"
    },
    "you": {
      "msaSigned": true,
      "msaVersion": "string",
      "needsKyc": true
    }
  }
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```