Organizations API

Manage organization settings, list and invite members, check balance, and configure modules.

Organizations are the top-level billing and access-control boundary in Crowdee. Every project, API key, and verification run belongs to an organization. Most users belong to a single organization; enterprise accounts may have multiple.

Endpoint Reference

Method	Path	Description
`GET`	`/v2/organizations`	List your organizations
`POST`	`/v2/organizations`	Create an organization
`GET`	`/v2/organizations/{orgId}`	Get organization details
`PUT`	`/v2/organizations/{orgId}`	Update organization
`GET`	`/v2/organizations/{orgId}/users`	List members
`POST`	`/v2/organizations/{orgId}/invite`	Invite a member
`GET`	`/v2/organizations/{orgId}/invitations`	List pending invitations
`GET`	`/v2/organizations/{orgId}/billing`	Get billing info

List Your Organizations

GET /v2/organizations

curl https://api.crowdee.ai/v2/organizations \
  -H "X-API-Key: crw_YOUR_API_KEY"

Get an Organization

GET /v2/organizations/{orgId}

curl https://api.crowdee.ai/v2/organizations/org_xyz789 \
  -H "X-API-Key: crw_YOUR_API_KEY"

Response

{
  "id": "org_xyz789",
  "name": "Acme News Desk",
  "slug": "acme-news-desk",
  "balance_cents": 48500,
  "currency": "EUR",
  "modules": ["content_verification", "crowdsourcing"],
  "plan": "professional",
  "memberCount": 8,
  "createdAt": "2024-01-10T09:00:00Z",
  "updatedAt": "2024-11-14T16:30:00Z"
}

balance_cents is the current prepaid credit in EUR cents (e.g. 48500 = €485.00). See Balance below.

Members

GET /v2/organizations/{orgId}/users

Returns all active members of the organization with their assigned roles.

curl https://api.crowdee.ai/v2/organizations/org_xyz789/users \
  -H "X-API-Key: crw_YOUR_API_KEY"

Response

{
  "data": [
    {
      "userId": "usr_abc111",
      "email": "alice@acmenews.com",
      "name": "Alice Berger",
      "role": "admin",
      "joinedAt": "2024-01-10T09:05:00Z"
    },
    {
      "userId": "usr_abc222",
      "email": "bob@acmenews.com",
      "name": "Bob Hartmann",
      "role": "user",
      "joinedAt": "2024-03-22T11:00:00Z"
    }
  ],
  "total": 8
}

Role reference

Role	Permissions
`viewer`	Read-only access to projects, files, and run results
`user`	Full read/write on projects and runs; cannot manage members or billing
`admin`	Full access including member management, invitations, and API key administration
`superadmin`	Crowdee-internal; not assignable via API

Invite a Member

POST /v2/organizations/{orgId}/invite

Sends an email invitation to the provided address. The recipient must accept via the link in the email before they appear in the members list.

Request body

Field	Type	Required	Description
`email`	string	Yes	Email address to invite
`role`	string	Yes	`"viewer"`, `"user"`, or `"admin"`

Invitations expire after 2 weeks. If the invitee has not accepted, resend the invitation using this endpoint with the same email — existing pending invitations for that address are replaced.

curl -X POST https://api.crowdee.ai/v2/organizations/org_xyz789/invite \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "carol@acmenews.com",
    "role": "user"
  }'

Response

{
  "id": "inv_def999",
  "organizationId": "org_xyz789",
  "email": "carol@acmenews.com",
  "role": "user",
  "status": "pending",
  "expiresAt": "2024-11-29T10:15:00Z",
  "createdAt": "2024-11-15T10:15:00Z"
}

Manage Pending Invitations

GET /v2/organizations/{orgId}/invitations

Lists all invitations that have been sent but not yet accepted or revoked.

curl https://api.crowdee.ai/v2/organizations/org_xyz789/invitations \
  -H "X-API-Key: crw_YOUR_API_KEY"

Response

{
  "data": [
    {
      "id": "inv_def999",
      "email": "carol@acmenews.com",
      "role": "user",
      "status": "pending",
      "expiresAt": "2024-11-29T10:15:00Z",
      "createdAt": "2024-11-15T10:15:00Z"
    }
  ],
  "total": 1
}

To revoke an invitation before it is accepted:

curl -X DELETE https://api.crowdee.ai/v2/invitations/inv_def999 \
  -H "X-API-Key: crw_YOUR_API_KEY"

Balance

The balance_cents field on the organization object contains your current prepaid credit in EUR cents.

balance_cents: 48500  →  €485.00

For balance top-up, use the dashboard at Settings → Billing, or contact sales@crowdee.ai for invoiced payments on Professional and Enterprise plans.

To retrieve just the billing details without the full organization object:

curl https://api.crowdee.ai/v2/organizations/org_xyz789/billing \
  -H "X-API-Key: crw_YOUR_API_KEY"

{
  "organizationId": "org_xyz789",
  "plan": "professional",
  "balance_cents": 48500,
  "currency": "EUR",
  "lastTopUp": {
    "amount_cents": 100000,
    "date": "2024-10-01T00:00:00Z"
  }
}

If a verification run cannot proceed due to insufficient balance, the API returns 402 PAYMENT_REQUIRED.

Modules

The modules array on the organization object lists the feature modules enabled for your account.

Module	Description
`content_verification`	Access to all 14 verification pipelines and the verification runs API
`crowdsourcing`	Access to Tier 2/3 pipelines that include human crowd review stages

{
  "modules": ["content_verification", "crowdsourcing"]
}

Attempting to start a run that requires a module your organization does not have enabled returns 403 FORBIDDEN with code MODULE_NOT_ENABLED.

Module changes are handled by the Crowdee team. Contact hello@crowdee.ai to enable or trial additional modules for your organization.

On this page