# The Agreement object

### The Agreement object

```json
{
  "id": "orca_test_1gkgAw3x8N9UarRebDtOBtdk",
  "object": "v2.orchestrated_commerce.agreement",
  "created": "2026-04-06T10:00:00Z",
  "initiated_by": "seller",
  "orchestrator_details": {
    "network_business_profile": "profile_test_61U92KWAstyE3VYhXA6U91t01FSQ3ByrZzKJOCR0y5ey",
    "name": "Test Agent"
  },
  "seller_details": {
    "network_business_profile": "profile_test_61UQtAVw2yEA80y4mA6UQtAVBKSQt4084jw8nwJXUUdk"
  },
  "status": "confirmed",
  "status_transitions": {
    "seller_confirmed_at": "2026-04-06T10:00:00Z",
    "orchestrator_confirmed_at": "2026-04-06T10:05:00Z",
    "terminated_at": null
  },
  "terminated_by": null
}
```

## Attributes

- `id` (string)
  The unique identifier for the agreement.

- `object` (string, value is "v2.orchestrated_commerce.agreement")
  String representing the object’s type. Objects of the same type share the same value of the object field.

- `created` (timestamp)
  The time at which the agreement was created.

- `initiated_by` (enum)
  The party that initiated the agreement.
Possible enum values:
  - `orchestrator`
    The orchestrator/agent.

  - `seller`
    The seller/merchant.

- `livemode` (boolean)
  Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.

- [`orchestrator_details`](https://docs.stripe.com/api/v2/orchestrated-commerce/agreements/object.md?query=orchestrator_details) (object)
  Details about the orchestrator.

- [`seller_details`](https://docs.stripe.com/api/v2/orchestrated-commerce/agreements/object.md?query=seller_details) (object)
  Details about the seller.

- `status` (enum)
  The current status of the agreement.
Possible enum values:
  - `confirmed`
    Both parties have confirmed the agreement.

  - `initiated`
    The agreement has been created and is awaiting confirmation from both parties.

  - `partially_confirmed`
    One party has confirmed the agreement and the other has not yet confirmed.

  - `terminated`
    The agreement has been terminated by one of the parties.

- [`status_transitions`](https://docs.stripe.com/api/v2/orchestrated-commerce/agreements/object.md?query=status_transitions) (object)
  Timestamps of key status transitions for the agreement.

- `terminated_by` (enum, nullable)
  The party that terminated the agreement, if applicable.
Possible enum values:
  - `orchestrator`
    The orchestrator/agent.

  - `seller`
    The seller/merchant.