# Opportunity (/api/reference/objects/opportunity)

The commercial agreement to work one or more roles for a company. It exists from the day the company is picked, at stage `IDENTIFIED`; there is no separate lead record before it. Its terms apply to every job under it.

```graphql
type Opportunity {
  agreementSignedOn: Date
  agreementStatus: AgreementStatus!
  agreementUrl: String
  company: Company!
  contacts(
    after: String
    before: String
    first: Int
    last: Int
  ): OpportunityContactConnection!
  createdAt: DateTime!
  currency: String!
  exclusiveUntil: Date
  exclusivity: OpportunityExclusivity!
  expectedFee: Decimal
  feeBasis: FeeBasis
  feePercent: Decimal
  fieldValues(
    after: String
    before: String
    first: Int
    last: Int
  ): FieldValueConnection!
  guaranteeDays: Int
  id: ID!
  jobs(
    after: String
    before: String
    first: Int
    last: Int
  ): JobConnection!
  lostReason: String
  name: String!
  nextStep: String
  nextStepDate: Date
  owner: User
  presentations(
    after: String
    before: String
    first: Int
    last: Int
  ): PresentationConnection!
  referredBy: Person
  source: OpportunitySource
  stage: OpportunityStage!
  stageEvents(
    after: String
    before: String
    first: Int
    last: Int
  ): OpportunityStageEventConnection!
  summary: String
  touches(
    after: String
    before: String
    first: Int
    last: Int
  ): TouchConnection!
  updatedAt: DateTime!
}
```

### Fields [#fields]

#### [`Opportunity.agreementSignedOn`](#agreement-signed-on) · [`Date`](/api/reference/scalars/date) `scalar` [#agreement-signed-on]
The day the agreement was signed.

#### [`Opportunity.agreementStatus`](#agreement-status) · [`AgreementStatus!`](/api/reference/enums/agreement-status) `non-null` `enum` [#agreement-status]
Where the written agreement stands.

#### [`Opportunity.agreementUrl`](#agreement-url) · [`String`](/api/reference/scalars/string) `scalar` [#agreement-url]
A link to the signed agreement, or to where it is kept.

#### [`Opportunity.company`](#company) · [`Company!`](/api/reference/objects/company) `non-null` `object` [#company]
The company it is with.

#### [`Opportunity.contacts`](#contacts) · [`OpportunityContactConnection!`](/api/reference/objects/opportunity-contact-connection) `non-null` `object` [#contacts]
Who at the company is involved, and as what, in the order they were added. One person can hold several roles.
##### [`Opportunity.contacts.after`](#opportunity-contacts-after) · [`String`](/api/reference/scalars/string) `scalar` [#opportunity-contacts-after]
Return the rows that follow this cursor.

##### [`Opportunity.contacts.before`](#opportunity-contacts-before) · [`String`](/api/reference/scalars/string) `scalar` [#opportunity-contacts-before]
Return the rows that come before this cursor.

##### [`Opportunity.contacts.first`](#opportunity-contacts-first) · [`Int`](/api/reference/scalars/int) `scalar` [#opportunity-contacts-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Opportunity.contacts.last`](#opportunity-contacts-last) · [`Int`](/api/reference/scalars/int) `scalar` [#opportunity-contacts-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Opportunity.createdAt`](#created-at) · [`DateTime!`](/api/reference/scalars/date-time) `non-null` `scalar` [#created-at]
When it was created.

#### [`Opportunity.currency`](#currency) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#currency]
The currency of its money, as a three-letter ISO 4217 code such as `GBP`.

#### [`Opportunity.exclusiveUntil`](#exclusive-until) · [`Date`](/api/reference/scalars/date) `scalar` [#exclusive-until]
The last day of exclusivity, when `exclusivity` is `EXCLUSIVE_UNTIL`.

#### [`Opportunity.exclusivity`](#exclusivity) · [`OpportunityExclusivity!`](/api/reference/enums/opportunity-exclusivity) `non-null` `enum` [#exclusivity]
Whether the workspace works the roles alone.

#### [`Opportunity.expectedFee`](#expected-fee) · [`Decimal`](/api/reference/scalars/decimal) `scalar` [#expected-fee]
The sum of its jobs' expected fees, in `currency`. Worked out by the server; null until a job has a figure.

#### [`Opportunity.feeBasis`](#fee-basis) · [`FeeBasis`](/api/reference/enums/fee-basis) `enum` [#fee-basis]
What `feePercent` is a percentage of.

#### [`Opportunity.feePercent`](#fee-percent) · [`Decimal`](/api/reference/scalars/decimal) `scalar` [#fee-percent]
The fee, as a percentage from 0 to 100. A new opportunity takes the company's default when it names none.

#### [`Opportunity.fieldValues`](#field-values) · [`FieldValueConnection!`](/api/reference/objects/field-value-connection) `non-null` `object` [#field-values]
The workspace's own fields that have a value on it, in the order they were first set.
##### [`Opportunity.fieldValues.after`](#opportunity-field-values-after) · [`String`](/api/reference/scalars/string) `scalar` [#opportunity-field-values-after]
Return the rows that follow this cursor.

##### [`Opportunity.fieldValues.before`](#opportunity-field-values-before) · [`String`](/api/reference/scalars/string) `scalar` [#opportunity-field-values-before]
Return the rows that come before this cursor.

##### [`Opportunity.fieldValues.first`](#opportunity-field-values-first) · [`Int`](/api/reference/scalars/int) `scalar` [#opportunity-field-values-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Opportunity.fieldValues.last`](#opportunity-field-values-last) · [`Int`](/api/reference/scalars/int) `scalar` [#opportunity-field-values-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Opportunity.guaranteeDays`](#guarantee-days) · [`Int`](/api/reference/scalars/int) `scalar` [#guarantee-days]
How many days of guarantee each placement carries.

#### [`Opportunity.id`](#id) · [`ID!`](/api/reference/scalars/id) `non-null` `scalar` [#id]
The opportunity's id.

#### [`Opportunity.jobs`](#jobs) · [`JobConnection!`](/api/reference/objects/job-connection) `non-null` `object` [#jobs]
The jobs worked under it, in the order they were created.
##### [`Opportunity.jobs.after`](#opportunity-jobs-after) · [`String`](/api/reference/scalars/string) `scalar` [#opportunity-jobs-after]
Return the rows that follow this cursor.

##### [`Opportunity.jobs.before`](#opportunity-jobs-before) · [`String`](/api/reference/scalars/string) `scalar` [#opportunity-jobs-before]
Return the rows that come before this cursor.

##### [`Opportunity.jobs.first`](#opportunity-jobs-first) · [`Int`](/api/reference/scalars/int) `scalar` [#opportunity-jobs-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Opportunity.jobs.last`](#opportunity-jobs-last) · [`Int`](/api/reference/scalars/int) `scalar` [#opportunity-jobs-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Opportunity.lostReason`](#lost-reason) · [`String`](/api/reference/scalars/string) `scalar` [#lost-reason]
Why it was lost. Always set once the stage is `LOST`.

#### [`Opportunity.name`](#name) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#name]
What it is called, such as `Magic: GTM hiring, Nov 2026`.

#### [`Opportunity.nextStep`](#next-step) · [`String`](/api/reference/scalars/string) `scalar` [#next-step]
What happens next, in words.

#### [`Opportunity.nextStepDate`](#next-step-date) · [`Date`](/api/reference/scalars/date) `scalar` [#next-step-date]
The day `nextStep` is due.

#### [`Opportunity.owner`](#owner) · [`User`](/api/reference/objects/user) `object` [#owner]
The member who owns it. Null when nobody does, or they have left the workspace.

#### [`Opportunity.presentations`](#presentations) · [`PresentationConnection!`](/api/reference/objects/presentation-connection) `non-null` `object` [#presentations]
The candidates shown to its buyers, newest recorded first.
##### [`Opportunity.presentations.after`](#opportunity-presentations-after) · [`String`](/api/reference/scalars/string) `scalar` [#opportunity-presentations-after]
Return the rows that follow this cursor.

##### [`Opportunity.presentations.before`](#opportunity-presentations-before) · [`String`](/api/reference/scalars/string) `scalar` [#opportunity-presentations-before]
Return the rows that come before this cursor.

##### [`Opportunity.presentations.first`](#opportunity-presentations-first) · [`Int`](/api/reference/scalars/int) `scalar` [#opportunity-presentations-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Opportunity.presentations.last`](#opportunity-presentations-last) · [`Int`](/api/reference/scalars/int) `scalar` [#opportunity-presentations-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Opportunity.referredBy`](#referred-by) · [`Person`](/api/reference/objects/person) `object` [#referred-by]
The person who referred it.

#### [`Opportunity.source`](#source) · [`OpportunitySource`](/api/reference/enums/opportunity-source) `enum` [#source]
How it came about.

#### [`Opportunity.stage`](#stage) · [`OpportunityStage!`](/api/reference/enums/opportunity-stage) `non-null` `enum` [#stage]
How far it has got.

#### [`Opportunity.stageEvents`](#stage-events) · [`OpportunityStageEventConnection!`](/api/reference/objects/opportunity-stage-event-connection) `non-null` `object` [#stage-events]
Every stage it has been given: the stage it was created at, then each change, with who made it. Newest first. Two changes in one request share a time, so the order is by id, not by `createdAt`.
##### [`Opportunity.stageEvents.after`](#opportunity-stage-events-after) · [`String`](/api/reference/scalars/string) `scalar` [#opportunity-stage-events-after]
Return the rows that follow this cursor.

##### [`Opportunity.stageEvents.before`](#opportunity-stage-events-before) · [`String`](/api/reference/scalars/string) `scalar` [#opportunity-stage-events-before]
Return the rows that come before this cursor.

##### [`Opportunity.stageEvents.first`](#opportunity-stage-events-first) · [`Int`](/api/reference/scalars/int) `scalar` [#opportunity-stage-events-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Opportunity.stageEvents.last`](#opportunity-stage-events-last) · [`Int`](/api/reference/scalars/int) `scalar` [#opportunity-stage-events-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Opportunity.summary`](#summary) · [`String`](/api/reference/scalars/string) `scalar` [#summary]
A running account of where it stands.

#### [`Opportunity.touches`](#touches) · [`TouchConnection!`](/api/reference/objects/touch-connection) `non-null` `object` [#touches]
The messages, calls and meetings that belong to it, newest recorded first.
##### [`Opportunity.touches.after`](#opportunity-touches-after) · [`String`](/api/reference/scalars/string) `scalar` [#opportunity-touches-after]
Return the rows that follow this cursor.

##### [`Opportunity.touches.before`](#opportunity-touches-before) · [`String`](/api/reference/scalars/string) `scalar` [#opportunity-touches-before]
Return the rows that come before this cursor.

##### [`Opportunity.touches.first`](#opportunity-touches-first) · [`Int`](/api/reference/scalars/int) `scalar` [#opportunity-touches-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Opportunity.touches.last`](#opportunity-touches-last) · [`Int`](/api/reference/scalars/int) `scalar` [#opportunity-touches-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Opportunity.updatedAt`](#updated-at) · [`DateTime!`](/api/reference/scalars/date-time) `non-null` `scalar` [#updated-at]
When it last changed.

### Returned By [#returned-by]

[`opportunity`](/api/reference/queries/opportunity)  `query`

### Member Of [#member-of]

[`AcceptChangeSuggestionPayload`](/api/reference/objects/accept-change-suggestion-payload)  `object` · [`AddOpportunityContactPayload`](/api/reference/objects/add-opportunity-contact-payload)  `object` · [`ChangeSuggestion`](/api/reference/objects/change-suggestion)  `object` · [`CreateOpportunityPayload`](/api/reference/objects/create-opportunity-payload)  `object` · [`FieldValue`](/api/reference/objects/field-value)  `object` · [`Job`](/api/reference/objects/job)  `object` · [`MoveOpportunityStagePayload`](/api/reference/objects/move-opportunity-stage-payload)  `object` · [`OpportunityEdge`](/api/reference/objects/opportunity-edge)  `object` · [`Presentation`](/api/reference/objects/presentation)  `object` · [`RemoveOpportunityContactPayload`](/api/reference/objects/remove-opportunity-contact-payload)  `object` · [`SetJobOpportunityPayload`](/api/reference/objects/set-job-opportunity-payload)  `object` · [`Touch`](/api/reference/objects/touch)  `object` · [`UpdateOpportunityPayload`](/api/reference/objects/update-opportunity-payload)  `object`