# Read a job (/docs/reference/jobs-id)

`GET https://api.getmattered.com/api/v1/developer/jobs/{id}`

One of the candidate's matches in full: description, pay, fit and whether GetMattered can apply to it (`canSend`). Free.

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

## Parameters

- `id` (path, required): The match id from `GET /developer/jobs/matches` or a search `jobMatchId`.

## Responses

### 200: The match.

```json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "canSend": {
          "type": "boolean",
          "description": "True when GetMattered can send an application for this match. False for a job it cannot send, such as a job-board posting with no employer posting GetMattered sends on.",
          "example": true
        },
        "company": {
          "type": [
            "string",
            "null"
          ]
        },
        "companyLogoUrl": {
          "type": [
            "string",
            "null"
          ]
        },
        "description": {
          "type": [
            "string",
            "null"
          ]
        },
        "extractedSkills": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "string"
          }
        },
        "id": {
          "type": "integer"
        },
        "jobType": {
          "type": [
            "string",
            "null"
          ]
        },
        "location": {
          "type": [
            "string",
            "null"
          ]
        },
        "matchScore": {
          "type": [
            "number",
            "null"
          ]
        },
        "postedAt": {
          "type": [
            "string",
            "null"
          ]
        },
        "salary": {
          "type": [
            "string",
            "null"
          ]
        },
        "salaryCurrency": {
          "type": [
            "string",
            "null"
          ],
          "description": "ISO-4217 currency code of the original (pre-normalization) salary range (USD, EUR, GBP, ...). Null when no salary was reported.",
          "example": "USD"
        },
        "salaryMaxUsd": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Upper bound of the listing salary range normalized to USD/year. Null when no parseable salary range exists.",
          "example": 180000
        },
        "salaryMinUsd": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Lower bound of the listing salary range normalized to USD/year. Null when no parseable salary range exists.",
          "example": 120000
        },
        "title": {
          "type": "string"
        },
        "url": {
          "type": "string"
        },
        "visaSponsorship": {
          "type": [
            "string",
            "null"
          ]
        },
        "whyGoodFit": {
          "type": [
            "string",
            "null"
          ],
          "description": "Enrichment-v2: one-paragraph (<=280 chars) neutral third-person blurb describing why a generic candidate might want this role. Null when the description is too thin.",
          "example": "Remote-first Series B fintech with strong mentorship, modern TypeScript stack, and paid conference budget. Limited on-call and a small team where individual impact is high."
        },
        "workArrangement": {
          "type": [
            "string",
            "null"
          ],
          "description": "Canonical work-arrangement enum (remote_global / remote_country / remote_region / hybrid / onsite / unknown). Drives the \"Remote\" chip + filter. Null only when enrichment hasn't run yet.",
          "example": "remote_global"
        }
      },
      "required": [
        "company",
        "companyLogoUrl",
        "description",
        "extractedSkills",
        "id",
        "jobType",
        "location",
        "matchScore",
        "postedAt",
        "salary",
        "salaryCurrency",
        "salaryMaxUsd",
        "salaryMinUsd",
        "title",
        "url",
        "visaSponsorship",
        "whyGoodFit",
        "workArrangement"
      ]
    },
    "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

### 404: Not Found

### 429: Too Many Requests

### 500: Internal Server Error

Error responses use the envelope in /errors.md.