# American Express Global Business Travel Custom Data Fields (CDF) API

**Canonical:** https://apis.io/apis/amex-gbt/amex-gbt-custom-data-fields-cdf-api/  
**Provider:** American Express Global Business Travel — https://apis.io/providers/amex-gbt/  
**Base URL:** https://apis.egencia.com/openconnect/api  
**Documentation:** https://www.amexglobalbusinesstravel.com/egencia-developer-center/api-details/user-sync-api

American Express Global Business Travel Custom Data Fields (CDF) API is one of 26 APIs that [American Express Global Business Travel](https://apis.io/providers/amex-gbt/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Custom Data Fields (CDF). The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, and authentication docs.

CDF APIs to retrieve Definitions and Manage Values.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/companies/{companyId}/cdfs` | Fetch all CDF definitions for a company or corresponding to a CDF name |
| GET | `/v1/companies/{companyId}/cdfs/{definitionId}/values` | Fetch all CDF values for a company and a CDF definition or corresponding to a CDF value |
| POST | `/v1/companies/{companyId}/cdfs/{definitionId}/values` | Create a new CDF value for a CDF of field type List |
| DELETE | `/v1/companies/{companyId}/cdfs/{definitionId}/values/{valueId}` | Delete a CDF value for a CDF of field type List |
| GET | `/v1/companies/{companyId}/cdfs/{definitionId}/values/{valueId}` | Fetch all linked CDF values |
| PUT | `/v1/companies/{companyId}/cdfs/{definitionId}/values/{valueId}` | Update a CDF value for a CDF of field type List |
| PATCH | `/v1/companies/{companyId}/cdfs/{definitionId}/values/{valueId}/link` | Update CDF Value by adding or removing child/parent links. This endpoint is available for CC1/CC2 linking for offices in EU/APAC. |

## Machine-readable artifacts (29)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/amex-gbt/refs/heads/main/openapi/amex-gbt-custom-data-fields-cdf-api-openapi.yml
- **APIReference** — https://apis.egencia.com/openconnect/docs/api-docs/UserSyncAPI
- **Documentation** — https://apis.egencia.com/openconnect/v1/api-info?name=User
- **Authentication** — https://apis.egencia.com/auth/v1/token
- **APIReference** — https://apis.egencia.com/openconnect-sso/docs/api-docs/sso
- **Documentation** — https://www.egencia.com/openconnect-sso-service/v1/api-info
- **APIReference** — https://apis.egencia.com/company/docs/api-docs/company-info-api
- **Documentation** — https://apis.egencia.com/company/v1/api-info?name=company-details
- **APIReference** — https://apis.egencia.com/openconnect/docs/api-docs/CompanyCDFAPI
- **Documentation** — https://apis.egencia.com/openconnect/v1/api-info?name=CompanyCustomData
- **APIReference** — https://apis.egencia.com/openconnect-validation/docs/api-docs/validation
- **Documentation** — https://www.egencia.com/openconnect-validation-service/v1/api-info
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/amex-gbt/refs/heads/main/asyncapi/amex-gbt-webhooks.yml
- **APIReference** — https://apis.egencia.com/openconnect-expense/docs/api-docs/expense
- **Documentation** — https://www.egencia.com/openconnect-expensestream-service/v1/api-info
- **APIReference** — https://apis.egencia.com/openconnect/docs/api-docs/GetBookingAPI
- **Documentation** — https://apis.egencia.com/openconnect/v1/api-info?name=Booking
- **APIReference** — https://apis.egencia.com/openconnect/docs/api-docs/CancellationDeletionAPI
- **Documentation** — https://apis.egencia.com/openconnect/v1/api-info?name=CancelAndDelete
- **APIReference** — https://apis.egencia.com/openconnect/docs/api-docs/ApprovalWorkflowAPI
- **Documentation** — https://apis.egencia.com/openconnect/v1/api-info?name=Approval
- **APIReference** — https://apis.egencia.com/approval/docs/api-docs
- **Documentation** — https://www.egencia.com/openconnect-approval-service/v1/api-info
- **APIReference** — https://apis.egencia.com/openconnect/docs/api-docs/ReceiptAPISPI
- **Documentation** — https://apis.egencia.com/openconnect/v1/api-info?name=Receipt
- **APIReference** — https://apis.egencia.com/dutyofcare/docs/api-docs/doc-service
- **Documentation** — https://apis.egencia.com/dutyofcare/v1/api-info
- **APIReference** — https://apis.egencia.com/bi/docs/api-docs/transaction-data-service
- **Documentation** — https://apis.egencia.com/bi/v1/api-info

## Other American Express Global Business Travel APIs (12)

- [American Express Global Business Travel Agent Assist Notes API](https://apis.io/apis/amex-gbt/amex-gbt-agent-assist-notes-api/)
- [American Express Global Business Travel Approval API](https://apis.io/apis/amex-gbt/amex-gbt-approval-api/)
- [American Express Global Business Travel Availability Probes Controller API](https://apis.io/apis/amex-gbt/amex-gbt-availability-probes-controller-api/)
- [American Express Global Business Travel bookings v1 API](https://apis.io/apis/amex-gbt/amex-gbt-bookings-v1-api/)
- [American Express Global Business Travel bookings v2 API](https://apis.io/apis/amex-gbt/amex-gbt-bookings-v2-api/)
- [American Express Global Business Travel Company Details API](https://apis.io/apis/amex-gbt/amex-gbt-company-details-api/)
- [American Express Global Business Travel Custom Data Field Cleanup Controller API](https://apis.io/apis/amex-gbt/amex-gbt-custom-data-field-cleanup-controller-api/)
- [American Express Global Business Travel Doc Audit Clean Up Controller API](https://apis.io/apis/amex-gbt/amex-gbt-doc-audit-clean-up-controller-api/)
- [American Express Global Business Travel DutyOfCare Data API](https://apis.io/apis/amex-gbt/amex-gbt-dutyofcare-data-api/)
- [American Express Global Business Travel Ecommerce Settings Controller API](https://apis.io/apis/amex-gbt/amex-gbt-ecommerce-settings-controller-api/)
- [American Express Global Business Travel Expense SPI API](https://apis.io/apis/amex-gbt/amex-gbt-expense-spi-api/)
- [American Express Global Business Travel Gdpr Controller API](https://apis.io/apis/amex-gbt/amex-gbt-gdpr-controller-api/)

## Tags

Custom Data Fields (CDF)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/amex-gbt/amex-gbt-custom-data-fields-cdf-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/amex-gbt/.