NewTell a voided invoice from a totally rectified one, without a second call
BeeL
Get StartedMulti-NIFVeriFactuStripeAPI ReferenceChangelog
Members

List account members

Scopemembers:read

Lists the members (people with access) of the account. Requires OWNER/ADMIN of that account.

GET
/v1/accounts/{account_id}/members

Authorization

AuthorizationBearer <token>

API Key authentication.

Format: Authorization: Bearer beel_sk_<key>

Scopes: API Keys use the same scopes as OAuth2 tokens. Each key is created with specific scopes that limit which endpoints it can access. The required scope for each endpoint is documented in the operation's security section under OAuth2.

Obtaining Keys: API Keys are managed from the BeeL dashboard

Security: API Keys are secret credentials. Do not share them or store them in source code

In: header

Path Parameters

account_idstring

Your own account, or an account you provisioned. It — not the credential — decides which account the operation acts on; a 403 is returned when you do not reach it, the same response an account that does not exist gets.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://app.beel.es/api/v1/accounts/497f6eca-6276-4993-bfeb-53cbbbba6f08/members"
{
  "success": true,
  "data": {
    "members": [
      {
        "member_id": "435a4844-006a-4cfc-a644-e8eb2dd2ca43",
        "person_id": "087e858e-473c-4f50-b5b0-c1df6c021550",
        "email": "user@example.com",
        "account_role": "OWNER",
        "grants": [
          {
            "company_id": "b2e6a1c3-1a5e-44ae-a8fd-81f76fd715cf",
            "access_level": "VIEW"
          }
        ],
        "permissions": {
          "can_change_role": true,
          "assignable_roles": [
            "OWNER"
          ],
          "can_remove": true,
          "can_transfer_ownership": true,
          "can_edit_grants": true
        }
      }
    ]
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}
{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication required"
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}
{
  "success": false,
  "error": {
    "code": "FORBIDDEN",
    "message": "You do not have permission to access this resource"
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}
{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Please try again in 60 seconds."
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}
{
  "success": false,
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal server error"
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

Create a draft invoice from a payment event of a NIF's connection POST

Builds a draft invoice from a payment event that could not be invoiced automatically, applying the same recipient resolution and tax treatment the automatic flow would have applied. The invoice is left as a draft so it can be reviewed and issued afterwards, and it is created in the NIF of the path. Only events that were not invoiced can produce a draft; otherwise the request returns `400`. If invoicing rules reject the resulting document, the request returns `422`.

Retrieve a member GET

Returns a single member of the account, with the same shape the list returns. Requires OWNER/ADMIN.