Skip to content

Data Exchange — opportunities

The current Data Exchange opportunity contract is a consumer-format import. Its path is relative to /data_exchange/api/v1. It validates the standard API key, then MongoDB mode resolves the tenant from its clientId or the Client-ID fallback. PostgreSQL mode rejects this MongoDB-only import after authentication.

Consumer-format imports always use the pwc data source.

The import runs with call_from_consumer=True. Before standardization, it archives the input under pwc/{environment}/{client_name}/message/raw/opportunity/{jobOpportunityKey}_{date}.json when BLOB_ENDPOINT is configured. Production imports still perform standardization only; other environments also run matching when the opportunity is eligible.

Method Path Purpose
POST /opportunities/import_opportunity_in_consumer_format standardize and process one raw opportunity

Opportunity discovery belongs to the Chatbot opportunity-search flow, not to a Data Exchange GET /opportunities endpoint.

The generated data exchange HTTP reference is the authoritative source for parameters, schemas, responses and examples.