Skip to main content
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 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 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 and Get Counterpart Entities reference pages.