Read Ivora's current terms

get/v1/legal/terms

Requires an API key

The current version of Ivora's Terms of Service and data processing addendum: each is Common Paper Standard Terms (linked, CC BY 4.0) incorporated by an Ivora Cover Page, given with its text (Markdown) and SHA-256. A team owner accepts both before the team turns on self-serve CSMS access, and again after a new major or minor version.

Returns · 200

dataarray of TermsDocumentRequired
Child attributes
- documentenumRequired
  terms_of_service (Ivora's Terms of Service) or dpa (the data processing addendum).
  One of terms_of_service, dpa
- titlestringRequired
- standard_termsStandardTermsRequired
  Child attributes
  - namestringRequired
    Common Paper Cloud Service Agreement Standard Terms, or Common Paper DPA Standard Terms.
  - versionstringRequired
    The Common Paper Standard Terms version the cover page incorporates (2.1 for the Terms of Service, 1.1 for the DPA).
  - urlstringRequired
    Where Common Paper hosts this version of the Standard Terms. Link it next to the cover page.
  - licensestringRequired
    CC BY 4.0.
  - license_urlstringRequired
  - attributionstringRequired
    The attribution to show with the Standard Terms.
- cover_page_versionstringRequired
  The Ivora Cover Page version (semver). A new major or minor version, or new Standard Terms, must be accepted again; a patch need not.
- effectivestringRequired
  The date the version takes effect (YYYY-MM-DD).
- sha256stringRequired
  SHA-256 of the cover page body, recorded with each acceptance: the exact text accepted.
- draftbooleanRequired
  true while the cover page still holds [LEGAL TEXT] placeholders for Ivora to fill in.
- bodystringRequired
  The Ivora Cover Page, in Markdown, linking the Standard Terms. Show it in full, with the Standard Terms link, before asking for acceptance.

Errors

401 Unauthorized 403 Forbidden 404 Not found 409 Conflict 422 Invalid request 429 Rate limited 502 Upstream error 503 Unavailable

GET /v1/legal/terms

curl --fail-with-body "https://api.ivoracharge.com/v1/legal/terms" \
  -H "Authorization: Bearer $IVORA_API_KEY"

Response · 200JSON

{
  "data": [
    {
      "document": "terms_of_service",
      "title": "string",
      "standard_terms": {
        "name": "bay-01",
        "version": "string",
        "url": "https://app.example.com/ivora/webhooks",
        "license": "string",
        "license_url": "https://app.example.com/return",
        "attribution": "string"
      },
      "cover_page_version": "string",
      "effective": "string",
      "sha256": "string",
      "draft": false,
      "body": "string"
    }
  ]
}

Requires an approved production API keyProduction access starts with a request, a short meeting with Ivora and a card on file, after which Ivora staff grant your account access. How to request access

Try itproduction · api.ivoracharge.com

Production API key iv_live_…

Paste a production api key (iv_live_…). Create keys in Developer tools. The key stays in this page's memory, is sent only to https://api.ivoracharge.com and clears when you reload. Test keys are refused.