# Upload a resume (/docs/reference/resume)

`POST https://api.getmattered.com/api/v1/developer/resume`

Uploads a new resume for the candidate, the way the GetMattered upload does: the same file types and 10 MB limit, and it becomes the resume GetMattered applies with. GetMattered reads the file before it answers, so the answer carries the text it read. Spends the tokens it uses plus the request fee, recorded as `parse`. At most 10 uploads a minute per account.

Authentication: `Authorization: Bearer gm_live_...` (see /authentication.md).

## Responses

### 200: The stored resume and the text GetMattered read from it.

```json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "description": "The resume document.",
          "example": 512
        },
        "mimeType": {
          "type": [
            "string",
            "null"
          ],
          "description": "The stored file type.",
          "example": "application/pdf"
        },
        "text": {
          "type": [
            "string",
            "null"
          ],
          "description": "The resume as text, as GetMattered read it from the file. Null when it found no readable text.",
          "example": "Jane Doe\nSenior Software Engineer..."
        },
        "title": {
          "type": "string",
          "example": "Jane Doe resume"
        },
        "status": {
          "type": "string",
          "enum": [
            "draft",
            "generating",
            "ready",
            "failed"
          ],
          "description": "`ready`: the resume is stored and read; `text` holds what GetMattered read, and is null when the file had no readable text (applications still send the file). `failed`: GetMattered could not read the file. `GET /developer/resume` answers the same resume afterwards.",
          "example": "ready"
        },
        "usage": {
          "type": "object",
          "properties": {
            "tokens": {
              "type": "integer",
              "description": "The tokens this call spent from the key owner's account: the work it ran plus the request fee.",
              "example": 450
            }
          },
          "required": [
            "tokens"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "id",
        "mimeType",
        "text",
        "title",
        "status",
        "usage"
      ],
      "additionalProperties": false
    },
    "meta": {
      "type": "object",
      "properties": {
        "duration": {
          "type": "number",
          "minimum": 0,
          "description": "Request duration in milliseconds",
          "example": 150
        },
        "performance": {
          "type": "object",
          "properties": {
            "dbQueries": {
              "type": "integer",
              "minimum": 0
            },
            "totalDbTime": {
              "type": "number",
              "minimum": 0
            }
          },
          "description": "Performance metrics (preview/local only)"
        },
        "requestId": {
          "type": "string",
          "description": "Unique request identifier",
          "example": "req_abc123"
        },
        "timestamp": {
          "type": "string",
          "format": "date-time",
          "description": "ISO 8601 timestamp",
          "example": "2026-11-17T12:00:00.000Z"
        },
        "version": {
          "type": "string",
          "description": "API version",
          "example": "v1"
        }
      }
    },
    "success": {
      "type": "boolean",
      "enum": [
        true
      ]
    }
  },
  "required": [
    "data",
    "success"
  ],
  "additionalProperties": false,
  "description": "Successful API response"
}
```

### 400: Bad Request

### 401: Unauthorized

### 402: The key owner's API balance has no tokens for this call. Nothing was spent.

### 403: The account holds as many documents as its plan allows, and none can be removed to make room. Nothing was stored.

### 404: Not Found

### 429: Too Many Requests

### 500: Internal Server Error

Error responses use the envelope in /errors.md.