Aziël
Inloggen
Particulier Voor persoonlijke zendingen. Zakelijk Voor bedrijven en organisaties.
Developer API

Integreer Aziël in je eigen systeem.

Maak zendingen aan, haal tarieven op en volg pakketten rechtstreeks vanuit je webshop, dashboard of eigen applicatie.

Start integreren → 
POST /api/versturen

{
  "recipient_name": "Jan Jansen",
  "postal_code": "1234 AB",
  "city": "Amsterdam"
}
Overzicht

Aziël API

De Aziël API gebruikt JSON voor alle requests en responses. Gebruik deze API om zendingen aan te maken, tarieven op te halen, trackinginformatie op te vragen en labels te downloaden.

Base URL https://aziel.nl/api/v1
Authenticatie

API-token gebruiken

Iedere request moet een Bearer token bevatten. 

Authorization: Bearer YOUR_API_TOKEN
Accept: application/json
Content-Type: application/json
401 Unauthorized

Geen token meegestuurd of token is ongeldig.

403 Forbidden

Token is geldig, maar heeft geen toegang tot deze actie.

POST /versturen Betaalde actie

Zending aanmaken

Maakt een nieuwe zending aan.

Let op

Requests naar deze endpoint met een live API-sleutel maken daadwerkelijk een zending aan. Bij succesvol aangemaakte zendingen worden de op dat moment geldende verzendkosten automatisch in mindering gebracht op het beschikbare accounttegoed. Gebruik een testsleutel tijdens ontwikkeling en het uitvoeren van tests.

Request body

recipient_name required* string

Naam van de ontvanger. Vereist wanneer recipient_company_name niet is ingevuld.

recipient_company_name required* string

Bedrijfsnaam van de ontvanger. Vereist wanneer recipient_name niet is ingevuld.

recipient_email optional email

E-mailadres van de ontvanger voor verzendupdates.

recipient_postal_code required string

Postcode van het afleveradres.

recipient_house_number required string

Huisnummer van het afleveradres.

recipient_house_number_addition optional string

Toevoeging bij het huisnummer, bijvoorbeeld A, bis of 12.

sender_name required* string

Naam van de afzender. Vereist wanneer sender_company_name niet is ingevuld.

sender_company_name required* string

Bedrijfsnaam van de afzender. Vereist wanneer sender_name niet is ingevuld.

sender_email required email

E-mailadres van de afzender.

sender_postal_code required string

Postcode van het afzendadres.

sender_house_number required string

Huisnummer van het afzendadres.

sender_house_number_addition optional string

Toevoeging bij het huisnummer.

parcel_size required enum

Formaat van het pakket. Mogelijke waarden: small, medium of large.

parcel_content optional string

Beschrijving van de inhoud van het pakket.

pickup_method required enum

Ophaalmethode. Momenteel ondersteund: home.

label_method required enum

Manier waarop het label wordt aangemaakt. Mogelijke waarden: carrier_print of self_print.

parcel_options optional array

Mogelijke waarden: priority, fragile en signature.

Voorbeeld request

  
{
  "recipient_email": "jan.jansen@example.nl",
  "recipient_name": "Jan Jansen",
  "recipient_company_name": "Jansen Transport B.V.",
  "recipient_house_number": "18",
  "recipient_house_number_addition": "",
  "recipient_postal_code": "4561WF",
  "sender_company_name": "Pietersen Handel B.V.",
  "sender_name": "Hans Pietersen",
  "sender_email": "hans.pietersen@example.nl",
  "sender_house_number": "2",
  "sender_house_number_addition": "G",
  "sender_postal_code": "3115ZX",
  "pickup_method": "home",
  "parcel_size": "large",
  "label_method": "self_print",
  "parcel_options": [
    "priority",
    "signature"
  ]
}

Mogelijke statuscodes

        
{
 "success": true,
 "message": "Shipment created successfully.",
 "tracking_code": "AZJCZIFI6E0C",
 "status": "registered",
 "label": {
  "status": "pending",
  "encoding": null,
  "mime_type": null,
  "content": null
 },
 "created_at": "2026-06-07T19:31:21Z"
}
          
      
        
{
 "success": false,
 "message": "Shipments are currently only available within the Netherlands."
}
          
      
        
{
 "success": false,
 "message": "Insufficient account balance."
}
          
      
        
{
 "success": false,
 "message": "The provided data is invalid.",
 "errors": {
   "sender_postal_code": [
     "The sender postal code field is required."
   ]
 }
}
GET /tarieven

Tarieven ophalen

Haalt de actuele tarieven op voor pakketformaten.

Mogelijke statuscodes

        
{
 "success": true,
 "prices": {
    "small": {
      "label": "small_package",
      "display_label": "Klein pakket",
      "max_weight_kg": 2,
      "price": 4.75
    },
    "medium": {
      "label": "medium_package",
      "display_label": "Medium pakket",
      "max_weight_kg": 5,
      "price": 5.75
    },
    "large": {
      "label": "large_package",
      "display_label": "Groot pakket",
      "max_weight_kg": 10,
      "price": 7.75
    }
  }
}
GET /verzendopties

verzendopties ophalen

Haalt de verzendopties op voor pakketten.

Mogelijke statuscodes

        
{
  "success": true,
  "options": {
    "fragile": {
      "label": "fragile_shipment",
      "display_label": "Breekbaar",
      "price": 1.5,
      "description": {
        "EN": "Extra care will be taken when handling this shipment.",
        "NL": "Extra voorzichtig behandeld tijdens transport."
      }
    },
    "priority": {
      "label": "priority_shipment",
      "display_label": "Prioriteit",
      "price": 2.5,
      "description": {
        "EN": "Your shipment will receive priority processing.",
        "NL": "Je zending krijgt voorrang tijdens verwerking en transport."
      }
    },
    "signature": {
      "label": "signature_required",
      "display_label": "Handtekening",
      "price": 1.95,
      "description": {
        "EN": "Recipient must sign upon delivery.",
        "NL": "De ontvanger tekent voor ontvangst van de zending."
      }
    }
  }
}