---
title: "Get contracts"
method: GET
path: "/characters/{character_id}/contracts"
tags: ["Contracts"]
---

# Get contracts

`GET /characters/{character_id}/contracts`

## Request

- Base URL: `https://esi.evetech.net`
- URL: `https://esi.evetech.net/characters/{character_id}/contracts`
- Auth: OAuth 2
  - Authorization code: `https://login.eveonline.com/v2/oauth/authorize`
  - Token URL: `https://login.eveonline.com/v2/oauth/token` scopes: `esi-contracts.read_character_contracts.v1`
- TypeScript: <https://skmtc.dev/evetech/apis/eve-spring-inebriation-esi-tranquility/docs/characters/:character_id/contracts/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns contracts available to a character, only if the character is issuer, acceptor or assignee. Only returns contracts no older than 30 days, or if the status is "in_progress".

## Path parameters

- `character_id` integer, required

## Query parameters

- `page` integer: Which page of results to return.

## Headers

- `Accept-Language` 'en' | 'de' | 'fr' | 'ja' | 'ru' | 'zh' | 'ko' | 'es'
- `If-None-Match` string
- `X-Compatibility-Date` '2025-12-16', date, required
- `X-Tenant` string
- `If-Modified-Since` string

## Response `200`

OK

- object[]
  - `acceptor_id` integer, required: Who will accept the contract
  - `assignee_id` integer, required: ID to whom the contract is assigned, can be alliance, corporation or character ID
  - `availability` 'public' | 'personal' | 'corporation' | 'alliance', required: To whom the contract is available
  - `buyout` number, double: Buyout price (for Auctions only)
  - `collateral` number, double: Collateral price (for Couriers only)
  - `contract_id` integer, required
  - `date_accepted` string, date-time: Date of confirmation of contract
  - `date_completed` string, date-time: Date of completed of contract
  - `date_expired` string, date-time, required: Expiration date of the contract
  - `date_issued` string, date-time, required: Сreation date of the contract
  - `days_to_complete` integer: Number of days to perform the contract
  - `end_location_id` integer: End location ID (for Couriers contract)
  - `for_corporation` boolean, required: true if the contract was issued on behalf of the issuer's corporation
  - `issuer_corporation_id` integer, required: Character's corporation ID for the issuer
  - `issuer_id` integer, required: Character ID for the issuer
  - `price` number, double: Price of contract (for ItemsExchange and Auctions)
  - `reward` number, double: Remuneration for contract (for Couriers only)
  - `start_location_id` integer: Start location ID (for Couriers contract)
  - `status` 'outstanding' | 'in_progress' | 'finished_issuer' | 'finished_contractor' | 'finished' | 'cancelled' | 'rejected' | 'failed' | 'deleted' | 'reversed', required: Status of the the contract
  - `title` string: Title of the contract
  - `type` 'unknown' | 'item_exchange' | 'auction' | 'courier' | 'loan', required: Type of the contract
  - `volume` number, double: Volume of items in the contract

## Other responses

- `default`: Error

## Changes

- **2026-07-27** `0b913165e49c`: 1 info
  - added the optional property `status` to the response with the `default` status

[Operation history](https://skmtc.dev/evetech/apis/eve-spring-inebriation-esi-tranquility/changes/characters/:character_id/contracts/get.md)

---

[API](https://skmtc.dev/evetech/apis/eve-spring-inebriation-esi-tranquility.md) - [All operations](https://skmtc.dev/evetech/apis/eve-spring-inebriation-esi-tranquility/llms.txt) - [OpenAPI document](https://skmtc.dev/evetech/apis/eve-spring-inebriation-esi-tranquility/revisions/110d1a0b1dfc?raw)