---
updatedAt: 2026-06-25T23:24:34.000Z
agentTools:
  projectIndex: https://docs.delivr.ai/llms.txt
---

# List integrations

Returns the integrations under a project or organization. Supply `project_id` (preferred) or `organization_id`. Credentials are never included; `has_credentials` reports whether they are set.


# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Integrations",
    "description": "Manage the integrations your exports deliver to: create an Amazon S3 or DelivrDSP destination, list and inspect your integrations, rotate credentials or rename them, and delete one.\n\nCredentials are write-only: you send them on create or update, and they are never returned. Responses carry a `has_credentials` flag instead.\n\nCreate supports `s3` and `delivrdsp`, which authenticate with credentials. Email (configured with recipients) and Slack / CRM (Salesforce, HubSpot) (which connect over OAuth) are set up in the dashboard. List and get return integrations of any type.\n\n**Authentication:** organization API key (`X-Api-Key` + `X-Api-Secret`).\n\n**Base URL:** `https://api.delivr.ai`\n",
    "version": "1.0",
    "contact": {
      "name": "Delivr.ai Support",
      "url": "https://delivr.ai"
    }
  },
  "servers": [
    {
      "url": "https://api.delivr.ai",
      "description": "Production"
    }
  ],
  "security": [
    {
      "ApiKeyAuth": [],
      "ApiSecretAuth": []
    }
  ],
  "tags": [
    {
      "name": "Integrations",
      "description": "Create, read, update, and delete the destinations your exports deliver to."
    }
  ],
  "paths": {
    "/api/v1/integrations": {
      "get": {
        "operationId": "listIntegrations",
        "tags": [
          "Integrations"
        ],
        "summary": "List integrations",
        "description": "Returns the integrations under a project or organization. Supply `project_id` (preferred) or `organization_id`. Credentials are never included; `has_credentials` reports whether they are set.\n",
        "parameters": [
          {
            "name": "project_id",
            "in": "query",
            "description": "Filter by project (UUID). Preferred scope.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "organization_id",
            "in": "query",
            "description": "Filter by organization (UUID). Used when `project_id` is absent.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "type",
            "in": "query",
            "description": "Filter by integration type: `s3`, `delivrdsp`, `email`, `slack`, `salesforce`, `hubspot`.",
            "schema": {
              "type": "string"
            },
            "example": "delivrdsp"
          }
        ],
        "responses": {
          "200": {
            "description": "The matching integrations.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Integration"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing `project_id`/`organization_id`, or an invalid UUID.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key / secret."
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Key",
        "description": "Organization API key (`dlvr_` prefixed), created in the dashboard at `https://app.delivr.ai/{org_id}/settings/api-keys`. Must be paired with the `X-Api-Secret` header."
      },
      "ApiSecretAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Secret",
        "description": "Secret half of the organization API key, paired with `X-Api-Key`. Both headers are required on every request."
      }
    },
    "schemas": {
      "Integration": {
        "type": "object",
        "required": [
          "id",
          "organization_id",
          "project_id",
          "type",
          "name",
          "has_credentials",
          "enabled",
          "created_at",
          "updated_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "organization_id": {
            "type": "string",
            "format": "uuid"
          },
          "project_id": {
            "type": "string",
            "format": "uuid"
          },
          "type": {
            "type": "string",
            "description": "Integration type: `s3`, `delivrdsp`, `email`, `slack`, `salesforce`, or `hubspot`."
          },
          "name": {
            "type": "string"
          },
          "config": {
            "type": "object",
            "description": "Non-secret provider settings. Shape varies by type. Never contains credentials."
          },
          "has_credentials": {
            "type": "boolean",
            "description": "Whether credentials are stored for this integration."
          },
          "enabled": {
            "type": "boolean"
          },
          "connection_status": {
            "type": "string",
            "description": "Last connection-check result, e.g. `ok`. Empty until a check has run."
          },
          "connection_checked_at": {
            "type": "string",
            "description": "When the connection was last checked (UTC, RFC3339)."
          },
          "connection_error": {
            "type": "string",
            "description": "Error from the last failed connection check, if any."
          },
          "created_at": {
            "type": "string",
            "description": "Creation timestamp (UTC, RFC3339)."
          },
          "updated_at": {
            "type": "string",
            "description": "Last-update timestamp (UTC, RFC3339)."
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string",
            "description": "Error message."
          }
        }
      }
    }
  }
}
```