> ## Documentation Index > Fetch the complete documentation index at: https://docs.conversion.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Campaign > Get a custom campaign by id, including its description and its campaign type's member statuses as `type.statuses`. Statuses are returned in the type's configured progression order. Archived campaigns return 404. ## OpenAPI ````yaml /openapi.json get /v2/campaigns/{campaignId} openapi: 3.1.0 info: title: Conversion API version: 2.0.0 description: >- The Conversion API lets you programmatically manage contacts, track custom events, and manage their associated data. servers: - url: https://pub-api.conversion.ai/api security: - apiKey: [] paths: /v2/campaigns/{campaignId}: get: summary: Get Campaign description: >- Get a custom campaign by id, including its description and its campaign type's member statuses as `type.statuses`. Statuses are returned in the type's configured progression order. Archived campaigns return 404. operationId: getCampaign parameters: - name: campaignId in: path required: true schema: type: string format: uuid description: The Conversion campaign id, as returned by `GET /v2/campaigns`. examples: campaign: value: b7c8d9e0-f1a2-3456-bcde-f01234567890 responses: '200': description: Campaign retrieved successfully. content: application/json: schema: type: object properties: data: type: object required: - campaign properties: campaign: type: object required: - id - name - type - sfdcCampaignId - memberCount - createdAt - updatedAt - description properties: id: type: string format: uuid description: The Conversion campaign id. examples: - b7c8d9e0-f1a2-3456-bcde-f01234567890 name: type: string description: >- The campaign's display name, unique within the workspace. examples: - Q3 Field Events type: type: object description: >- The campaign type the campaign belongs to. Types are defined in the dashboard. required: - id - name - systemType - statuses properties: id: type: string format: uuid description: The campaign type id. examples: - 3c9d2b1a-8e4f-4a6b-9c0d-2e3f4a5b6c7d name: type: string description: >- The type's display name, as configured in the dashboard. examples: - Field Event systemType: type: string enum: - CUSTOM description: >- The system classification of the campaign type. Currently `CUSTOM`. statuses: type: array description: >- The member statuses configured for the campaign type, in progression order. Use a status's `id` or `name` as `statusId` or `status` when adding members. items: type: object required: - id - name - isSuccess properties: id: type: string format: uuid description: The campaign status id. name: type: string description: The status's display name. examples: - Attended isSuccess: type: boolean description: >- Whether the status counts as a successful outcome for the campaign. sfdcCampaignId: type: - string - 'null' description: >- The id of the Salesforce campaign this campaign is linked to, or `null` if the campaign is not linked to Salesforce. examples: - 701Ho00000AbCdEfGH memberCount: type: integer description: The total number of members in the campaign. examples: - 42 createdAt: type: string format: date-time description: When the campaign was created. updatedAt: type: string format: date-time description: When the campaign was last updated. description: type: - string - 'null' description: The campaign's description, or `null` if not set. examples: - Events run by the field team examples: success: summary: A campaign with its type's statuses value: data: campaign: id: b7c8d9e0-f1a2-3456-bcde-f01234567890 name: Q3 Field Events type: id: 3c9d2b1a-8e4f-4a6b-9c0d-2e3f4a5b6c7d name: Field Event systemType: CUSTOM statuses: - id: 7e8f9a0b-1c2d-4e3f-8a4b-5c6d7e8f9a0b name: Registered isSuccess: false - id: 8f9a0b1c-2d3e-4f4a-9b5c-6d7e8f9a0b1c name: Attended isSuccess: true sfdcCampaignId: 701Ho00000AbCdEfGH memberCount: 42 createdAt: '2026-05-01T12:00:00Z' updatedAt: '2026-06-11T09:30:00Z' description: Events run by the field team '401': description: Authentication failed. content: application/json: schema: $ref: '#/components/schemas/Error' examples: unauthorized: summary: Missing or invalid API key value: error: code: unauthorized message: API key is required '404': description: The requested resource was not found. content: application/json: schema: $ref: '#/components/schemas/Error' examples: campaign-not-found: summary: Campaign not found value: error: code: campaign_not_found message: campaign not found '500': description: An unexpected server error occurred. content: application/json: schema: $ref: '#/components/schemas/Error' examples: internal: summary: Internal error value: error: code: internal_error message: failed to load campaign components: schemas: Error: type: object properties: error: type: object required: - code - message properties: code: type: string description: A machine-readable error code. examples: - invalid_email message: type: string description: A human-readable error description. examples: - 'invalid email format: not-an-email' securitySchemes: apiKey: type: apiKey in: header name: X-API-Key description: >- Your Conversion API key. Found in **Settings > Integrations** in the dashboard. Format: `sk_live__`. ````