> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ofiniti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Entity management

> Manage contracts and counterpart entities referenced from nominations.

Contracts and entities provide reference data you attach to nominations. Contracts can be referenced from nominations via the `contractReference` field in the nomination's delivery details.

[Contracts](/api-reference/entity-management/creates-or-updates-a-contract) are idempotent on `reference` (alphanumeric and hyphens only, at most 100 characters). A contract has a name, an optional external reference, an optional type (`term` or `spot`) and price type (`floating` or `fixed`), optional UTC start and end dates, and optional scoping lists: supplier entity references, port UN/LOCODEs, counterpart company identifiers, and counterpart entity references.

[Counterpart entities](/api-reference/entity-management/creates-or-updates-a-counterpart-entity) are also idempotent on `reference`. `email` must be a valid email address (at most 320 characters) and `phoneNumber` may contain only digits, spaces, and the characters `+ - ( )`. The returned shapes are documented on the [Get Company Entities](/api-reference/entity-management/retrieves-all-entities-available-for-your-company) and [Get Counterpart Entities](/api-reference/entity-management/retrieves-all-counterpart-entities-available-for-your-company) reference pages.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.