Sign in
Opportunities

List opportunities for the authenticated operator

Changed on
get/operator/opportunities

Request

  • Base URL: https://api.ced.pagopa.it/api/ced-portal/v1
  • URL: https://api.ced.pagopa.it/api/ced-portal/v1/operator/opportunities
  • Auth: HTTP bearer

Query parameters

offsetinteger
limitinteger
status'draft' | 'test_pending' | 'test_rejected' | 'test_passed' | 'published' | 'scheduled' | 'scheduled_suspension' | 'suspended'

Filter by opportunity status. "scheduled" and "scheduled_suspension" are derived statuses (not stored): "scheduled" matches published opportunities whose dateFrom is still in the future; "published" matches those already effective (dateFrom <= today) with no future suspendFrom; "scheduled_suspension" matches live published opportunities with a future suspendFrom.

searchstring

Case-insensitive text search on the opportunity name.

categoryIdstring
sortBy'createdAt' | 'updatedAt'
sortOrder'asc' | 'desc'

Response

Paginated list of operator opportunities

totalinteger required

Changes

  • bff25e201186Revision changes
    • ○

      added the optional property // to the response with the status

    • ○

      added the optional property // to the response with the status

  • 246d05d91a1bRevision changes
    • ○

      added the non-success response with the status