Direct naar inhoud

API-referentie

Account en organisatie

Controleer welke organisatie en sleutel je gebruikt en lees of wijzig de organisatiegegevens.

Basis-URL: https://factora.one/api/v1

Overzicht

Gebruik GET /me als verbindingstest bij het opzetten van een koppeling. De organisatiegegevens bevatten ook de nummering van facturen en offertes en de standaard betalingstermijn.

Endpoints

GET/me

Huidige sleutel en organisatie

Geeft de organisatie achter de sleutel en de naam en het laatste gebruik van de sleutel.

curl "https://factora.one/api/v1/me" \
  -H "Authorization: Bearer $FACTORA_API_KEY" \
  -H "Accept: application/json"

200 Voorbeeldantwoord 

{
  "data": {
    "organization": {
      "id": "9d3c5e2a-1b7f-4c0e-9a51-2f6d8b7e4c10",
      "name": "Demo BV",
      "email": "info@demo.nl",
      "reply_to_email": "administratie@demo.nl",
      "phone": "020-1234567",
      "website": "https://demo.nl",
      "vat_number": "NL001234567B01",
      "coc_number": "87654321",
      "address": "Keizersgracht 1",
      "zipcode": "1015 AA",
      "city": "Amsterdam",
      "country": "NL",
      "iban": "NL91ABNA0417164300",
      "bic": "ABNANL2A",
      "bank_name": "ABN AMRO",
      "payment_terms_days": 14,
      "payments_enabled": true,
      "invoice_prefix_enabled": true,
      "invoice_number_prefix": "2026-",
      "next_invoice_number": 143,
      "quote_prefix_enabled": true,
      "quote_number_prefix": "OFF-2026-",
      "next_quote_number": 32,
      "timezone": "Europe/Amsterdam",
      "is_active": true,
      "created_at": "2026-01-05T10:00:00.000000Z",
      "updated_at": "2026-11-12T08:00:00.000000Z"
    },
    "api_key": {
      "id": "9d3c5e2a-77aa-4b1c-8d0e-1a2b3c4d5e6f",
      "name": "Webshop-koppeling",
      "last_used_at": "2026-11-12T08:14:03.000000Z"
    }
  }
}
GET/organization

Organisatie tonen

Alle organisatiegegevens, inclusief bankgegevens, nummering en betalingstermijn.

curl "https://factora.one/api/v1/organization" \
  -H "Authorization: Bearer $FACTORA_API_KEY" \
  -H "Accept: application/json"

200 Voorbeeldantwoord 

{
  "data": {
    "id": "9d3c5e2a-1b7f-4c0e-9a51-2f6d8b7e4c10",
    "name": "Demo BV",
    "email": "info@demo.nl",
    "reply_to_email": "administratie@demo.nl",
    "phone": "020-1234567",
    "website": "https://demo.nl",
    "vat_number": "NL001234567B01",
    "coc_number": "87654321",
    "address": "Keizersgracht 1",
    "zipcode": "1015 AA",
    "city": "Amsterdam",
    "country": "NL",
    "iban": "NL91ABNA0417164300",
    "bic": "ABNANL2A",
    "bank_name": "ABN AMRO",
    "payment_terms_days": 14,
    "payments_enabled": true,
    "invoice_prefix_enabled": true,
    "invoice_number_prefix": "2026-",
    "next_invoice_number": 143,
    "quote_prefix_enabled": true,
    "quote_number_prefix": "OFF-2026-",
    "next_quote_number": 32,
    "timezone": "Europe/Amsterdam",
    "is_active": true,
    "created_at": "2026-01-05T10:00:00.000000Z",
    "updated_at": "2026-11-12T08:00:00.000000Z"
  }
}
PATCH/organization

Organisatie bijwerken

Werkt alleen de meegestuurde velden bij.

Recht (app-login)
settings.manage

Body

  • namestring

    Max. 255 tekens; mag niet leeg zijn

  • addressstring

    Max. 255

  • zipcodestring

    Max. 20

  • citystring

    Max. 100

  • countrystring

    Max. 100

  • vat_numberstring

    Max. 50

  • coc_numberstring

    Max. 50

  • email, reply_to_email, phone, websitestring

    Contactgegevens

  • iban, bic, bank_namestring

    Bankgegevens op facturen

  • payment_terms_daysinteger

    Standaard betalingstermijn in kalenderdagen

  • payments_enabledboolean

    Online betalen op facturen

  • invoice_prefix_enabled, invoice_number_prefix, next_invoice_numbermixed

    Factuurnummering

  • quote_prefix_enabled, quote_number_prefix, next_quote_numbermixed

    Offertenummering

  • timezonestring

    Tijdzone van de organisatie

curl -X PATCH "https://factora.one/api/v1/organization" \
  -H "Authorization: Bearer $FACTORA_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Demo BV",
    "reply_to_email": "administratie@demo.nl",
    "phone": "020-1234567"
  }'

200 Voorbeeldantwoord 

{
  "data": {
    "id": "9d3c5e2a-1b7f-4c0e-9a51-2f6d8b7e4c10",
    "name": "Demo BV",
    "email": "info@demo.nl",
    "reply_to_email": "administratie@demo.nl",
    "phone": "020-1234567",
    "website": "https://demo.nl",
    "vat_number": "NL001234567B01",
    "coc_number": "87654321",
    "address": "Keizersgracht 1",
    "zipcode": "1015 AA",
    "city": "Amsterdam",
    "country": "NL",
    "iban": "NL91ABNA0417164300",
    "bic": "ABNANL2A",
    "bank_name": "ABN AMRO",
    "payment_terms_days": 14,
    "payments_enabled": true,
    "invoice_prefix_enabled": true,
    "invoice_number_prefix": "2026-",
    "next_invoice_number": 143,
    "quote_prefix_enabled": true,
    "quote_number_prefix": "OFF-2026-",
    "next_quote_number": 32,
    "timezone": "Europe/Amsterdam",
    "is_active": true,
    "created_at": "2026-01-05T10:00:00.000000Z",
    "updated_at": "2026-11-12T08:00:00.000000Z"
  }
}

Lees ook