Voogd & Voogd

https://docs.voogd.com
Admin
Voogd & Voogd provides insurance APIs and webmodules for calculating quotes, managing policies,...
Tokens:226,498
Snippets:933
Trust Score:8.9
Update:4 weeks ago
Show doc for...
Tokens:
Raw
### Example response for VoordeelPakket berekening

Source: https://docs.voogd.com/docs/company-information

Example JSON response for creating a VoordeelPakket berekening. Shows a calculation with product details, tariffs, and monetary values.

```json
{
	"application/json": {
		"Afkeuringen": [],
		"BerekendVoorProces": "Migratie",
		"Betalingstermijn": "Maand",
		"Clausules": [],
		"Id": "56fc2e6a2d3a270ae099305d",
		"Kosten": 2.25,
		"Marktsegment": "Particulier",
		"Pakketkorting": 116.16,
		"PercentageAssurantiebelasting": 21,
		"Premie": 1161.6,
		"Producten": [
			{
				"Id": "4b68b4d4-16ea-4ee9-8496-74a94152f404",
				"Ingangsdatum": "2025-05-01T00:00:00+02:00",
				"MaximaalPercentageProvisie": 27.5,
				"Meldingen": [],
				"Mutatieredenen": [],
				"Naam": "Aanhangwagen",
				"Omschrijving": "Aanhangwagen",
				"ProvisieInstelbaar": true,
				"RelatiekortingAanpasbaar": false,
				"RelatiekortingMogelijk": false,
				"Soort": "Nieuw",
				"Status": "Actief",
				"Tarieven": [
					{
						"Afkeuringen": [],
						"AfwijkingVanTotaal": 0,
						"Clausules": [],
						"ExtraDetails": [],
```

--------------------------------

### Example advice details response

Source: https://docs.voogd.com/docs/ppc-api

Example JSON response for the advice details endpoint, showing a single advice object with fields like AdviceEffectiveDate, ContractNumber, and PackageId.

```json
{
	"AdviceEffectiveDate": "2026-09-21T13:46:03Z",
	"ContractNumber": "string",
	"Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
	"IsAdviceEmailSentToCustomer": true,
	"IsNoBetterAlternativeEmailSentToCustomer": true,
	"PackageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
	"RunId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
```

--------------------------------

### BestelautoProfiel JSON Example

Source: https://docs.voogd.com/docs/product-delivery-van

Example JSON representation of the BestelautoProfiel model, showing all attributes with example values. Use this as a reference for constructing requests or responses.

```json
BestelautoProfiel {
	"BpmVerrekenen": true,
	"BtwVerrekenen": true,
	"GebruiktAlsVerkoopwagen": true,
	"GewensteTarieven": [
		{
			"TariefSoort": "string"
		}
	],
	"GrensoverschrijdendVervoer": true,
	"Id": "00000000-0000-0000-0000-000000000000",
	"InclusiefSpecialeLimietTarieven": true,
	"Ingangsdatum": "2026-09-21T13:46:08Z",
	"Kenteken": "string",
	"Leaseauto": true,
	"PechhulpAanhangerMeeverzekeren": true,
	"PechhulpWoonplaatsMeeverzekeren": true,
	"SbiCode": "string",
	"SchadeInzittendenMeeverzekeren": true,
	"VrijeKeuzeHerstel": true
}
```

--------------------------------

### Example advice list response

Source: https://docs.voogd.com/docs/ppc-api

Example JSON response for the advice list endpoint, showing a single advice item with fields like ContractNumber, Id, and RenewalDate.

```json
{
	"Items": [
		{
			"ContractNumber": "string",
			"Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
			"IsAdviceEmailSentToCustomer": true,
			"IsNoBetterAlternativeEmailSentToCustomer": true,
			"PackageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
			"RenewalDate": "2026-09-21T13:46:03Z"
		}
	]
}
```

--------------------------------

### Example response for maakmutatieberekening

Source: https://docs.voogd.com/docs/premie-geldigheid

Example response from the maakmutatieberekening endpoint, including the new berekening id and status flags.

```json
{
    "id": "45dbb3cc-9d47-4e5e-82aa-909955e9c2b6",
    "isAfwijkendVerzekeringnemerAdresAangepast": true,
    "isSvjGewijzigd": false,
    "isTariefBeperkingToegepast": false,
    "openstaandeAanvraagId": "6676ee5f-e1c2-4532-917f-54b019071eb1"
}
```

--------------------------------

### Example response for creating a new request

Source: https://docs.voogd.com/docs/package-request

Example JSON response for creating a new request, containing the Id of the created request.

```json
{
	"application/json": {
		"Id": "dd2c3b6d-a112-4488-87f2-7da47d8b9683"
	}
}
```

--------------------------------

### GET /advice/v1/advice

Source: https://docs.voogd.com/docs/ppc-api

Retrieve a paginated list of advice proposals. The list is available monthly, two weeks before the renewal date, and disappears once the renewal has started.

```APIDOC
## GET /advice/v1/advice

### Description
Retrieve a paginated list of advice proposals. The list is available monthly, two weeks before the renewal date, and disappears once the renewal has started.

### Method
GET

### Endpoint
/advice/v1/advice

### Parameters
#### Query Parameters
- **Year** (integer) - Required - The renewal year.
- **Month** (integer) - Required - The renewal month.
- **PageNumber** (integer) - Required - The desired page number (starts with page 1).
- **PageSize** (integer) - Required - The number of items per page (maximum of 200).
- **SortBy** (AdviceSummarySortColumn) - Required - The column to sort by.
- **SortDirection** (SortDirection) - Required - The sort direction.

#### Request Body
- **AdviceFilter** (object) - Required - Filter or search criteria to limit the sorted results.

### Response
#### Success Response (200)
- **Items** (array) - The records on the current page.
- **PageNumber** (integer) - The number of the current page (starts with page 1).
- **PageSize** (integer) - The number of items per page.
- **TotalPages** (integer, optional) - Total number of pages.
- **TotalRecords** (integer) - Total number of records.

#### Response Example
```json
{
  "Items": [
    {
      "ContractNumber": "string",
      "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "IsAdviceEmailSentToCustomer": true,
      "IsNoBetterAlternativeEmailSentToCustomer": true,
      "PackageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "RenewalDate": "2026-09-21T13:46:03Z"
    }
  ]
}
```
```

--------------------------------

### Strafbaar Feit Veroordeeld JSON Example

Source: https://docs.voogd.com/docs/package-request

Example of a strafbaar feit veroordeeld data with a specific StrafbaarFeit value.

```json
"StrafbaarFeit": "Wederrechtelijke benadeling van anderen, zoals vernieling, beschadiging, opzettelijke brandstichting, teweegbrengen van een ontploffing, afpersing en afdreiging;"
```

--------------------------------

### Strafbare Feiten JSON Example

Source: https://docs.voogd.com/docs/package-request

Example of strafbare feiten data with fields for StrafOfSanctieBeschrijving, StrafbaarFeitVeroordeeld, DocumentId, and StrafbaarFeit.

```json
"StrafOfSanctieBeschrijving": "Description",
"StrafbaarFeitVeroordeeld": false,
"DocumentId": "fd556420-8288-44a7-ad93-8c0d6dee93c8",
"StrafbaarFeit": "Onrechtmatig verkregen of te verkrijgen voordeel, zoals diefstal, heling, verduistering, bedrog, oplichting, omkoping, valsheid in geschrifte;"
```

--------------------------------

### GET /product/v2/berekeningen/{berekeningid}/producten/{productid}/tarieven/{tariefkenmerk}/{tariefversie}/clausules/document

Source: https://docs.voogd.com/docs/package-selection

Downloads a PDF containing all currently selected coverages (clauses) for a given calculation, product, and tariff.

```APIDOC
## GET /product/v2/berekeningen/{berekeningid}/producten/{productid}/tarieven/{tariefkenmerk}/{tariefversie}/clausules/document

### Description
Ophalen van een document met clausules voor een berekening met een bepaald product en tarief.

### Method
GET

### Endpoint
/product/v2/berekeningen/{berekeningid}/producten/{productid}/tarieven/{tariefkenmerk}/{tariefversie}/clausules/document

### Parameters
#### Path Parameters
- **berekeningid** (string) - Required - Het id van de berekening
- **productid** (string) - Required - Het id van het product
- **tariefkenmerk** (integer) - Required - Het tariefkenmerk
- **tariefversie** (integer) - Required - De tariefversie

### Response
#### Success Response (200)
- **file** (file) - Het PDF-document met clausules

#### Response Example
```
"file"
```
```

--------------------------------

### POST /advice/v1/advice/{adviceId}/create-application

Source: https://docs.voogd.com/docs/ppc-followup

Zet een voorstel om in een aanvraag wanneer er een besparing mogelijk is. Na het creëren van de aanvraag kan het voorstel met de consument worden gedeeld via het endpoint voor het versturen van het advies.

```APIDOC
## POST /advice/v1/advice/{adviceId}/create-application

### Description
Zet een voorstel om in een aanvraag wanneer er een besparing mogelijk is. Na het creëren van de aanvraag kan het voorstel met de consument worden gedeeld via het endpoint voor het versturen van het advies.

### Method
POST

### Endpoint
/advice/v1/advice/{adviceId}/create-application

### Parameters
#### Path Parameters
- **adviceId** (string) - Required - Het unieke identificatienummer van het advies.

### Request Example
```json
"string"
```

### Response
#### Success Response (200)
Geen inhoud beschreven in de bron.

#### Response Example
Geen inhoud beschreven in de bron.

```

--------------------------------

### Recreatiewoningen JSON Example

Source: https://docs.voogd.com/docs/package-request

Example of recreatiewoningen data with fields for AantalVerhuurdeWeken, Adres, Bouwjaar, and various boolean flags for questions.

```json
"Recreatiewoningen": [
  "AantalVerhuurdeWeken": "Weken0Tm17",
  "AcceptatievragenVereist": false,
  "Adres": {
    "Huisnummer": 55,
    "Postcode": "3241XG"
  },
  "Bouwjaar": 1990,
  "BouwjaarVraagStellen": false,
  "GebouwenBinnen10mMetAfwijkendeBestemmingVraagStellen": false,
  "Id": "733f51e4-9d6f-41b7-8d85-aa8e453ea1c2",
  "Onderhoudstoestand": "Goed",
  "OnderhoudstoestandVraagStellen": false,
  "ToelichtingWoonVestigingsomgevingVraagStellen": false,
  "Verhuur": "Incidenteel",
  "VerhuurVraagStellen": false,
  "VerhuurdAan": "Particulier",
  "WoningBinnen10mMetAfwijkendeBouwaardVraagStellen": false,
  "WoonVestigingsomgeving": "Anders",
  "WoonVestigingsomgevingNaamVraagStellen": false
]
```

--------------------------------

### GET /product/v2/berekeningen/{berekeningid}/kampeerautoproducten/{productid}

Source: https://docs.voogd.com/docs/product-camper-van

Haalt productinformatie op voor een kampeerauto binnen een specifieke berekening. Dit endpoint kan worden gebruikt om aanvullende productdetails te tonen na het aanmaken van een berekening.

```APIDOC
## GET /product/v2/berekeningen/{berekeningid}/kampeerautoproducten/{productid}

### Description
Haalt productinformatie op voor een kampeerauto binnen een specifieke berekening. Dit endpoint kan worden gebruikt om aanvullende productdetails te tonen na het aanmaken van een berekening.

### Method
GET

### Endpoint
/product/v2/berekeningen/{berekeningid}/kampeerautoproducten/{productid}

### Parameters
#### Path Parameters
- **berekeningid** (string) - Required - Het id van de berekening
- **productid** (string) - Required - Het id van het product

#### Query Parameters
- **alletarieven** (boolean) - Optional - Alle tarieven (standaard) of alleen geselecteerde tarieven ophalen?
- **alledekkingen** (boolean) - Optional - Alle dekkingen (standaard) of alleen geselecteerde dekkingen ophalen?
- **inclusiefassurantiebelasting** (boolean) - Optional - Bedragen inclusief (standaard) of exclusief assurantiebelasting?
- **adviseurnummer** (integer) - Optional - Het nummer van de administratie waarmee de berekening uitgevoerd wordt

### Request Example
Geen request body vereist.

### Response
#### Success Response (200)
- **GarantieTarieven** (array) - De garantie tarieven
- **Id** (string) - Het id van het product
- **Ingangsdatum** (string) - Ingangsdatum van product
- **KampeerautoTarieven** (array) - De kampeerauto tarieven
- **Omschrijving** (string) - De omschrijving van het product
- **Status** (ProductStatus) - De status van het product

#### Response Example
```json
{
  "GarantieTarieven": [
    {
      "GarantieDekkingen": [
        {
          "Kortingen": [
            {
              "EinddatumTot": "2026-09-21T13:46:08Z",
              "KortingSoort": "string",
              "Omschrijving": "string"
            }
          ],
          "Mutatieredenen": [
            {
              "Omschrijving": "string"
            }
          ]
        }
      ],
      "IsHuidigeNieuwsteVersie": true,
      "Mutatieredenen": [
        {
          "Omschrijving": "string"
        }
      ],
      "Naam": "string"
    }
  ],
  "Id": "00000000-0000-0000-0000-000000000000",
  "Ingangsdatum": "2026-09-21T13:46:08Z",
  "KampeerautoTarieven": [
    {
      "IsHuidigeNieuwsteVersie": true,
      "KampeerautoDekkingen": [
        {
          "AccessoiresDekkingen": [
            {
              "Kortingen": [
                {
                  "EinddatumTot": "2026-09-21T13:46:08Z",
                  "KortingSoort": "string",
                  "Omschrijving": "string"
                }
              ],
              "Mutatieredenen": [
                {
                  "Omschrijving": "string"
                }
              ],
              "Verplicht": true
            }
          ],
          "BonusMalusVanToepassingOpPremieAanrijding": true,
          "BonusMalusVanToepassingOpPremieDiefstal": true,
          "BonusMalusVanToepassingOpPremieNatuur": true
        }
      ]
    }
  ]
}
```

```

--------------------------------

### string

Source: https://docs.voogd.com/docs/product-camper-van

string

```string
string, 
```

--------------------------------

### Package Request JSON Example

Source: https://docs.voogd.com/docs/package-request

Example of a package request payload containing fields like Ingangsdatum, Maatschappij, Maatwerk, and Slotvragen. Includes nested objects for recreatiewoningen and slot questions.

```json
"Ingangsdatum": "2025-05-01T00:00:00+02:00",
"Maatschappij": {
  "Naam": "ASR",
  "Nummer": 31
},
"Maatwerk": {
  "ExtraEigenRisicos": [
    "Bedrag": 500,
    "Id": "00000000-0000-0000-0000-000000000000",
    "Omschrijving": "Test"
  ],
  "Redenen": [
    "Id": "6cb8ad76-22ba-4b40-bb5e-5e41c5ef92fd",
    "RedenNummer": 123
    "Naam": "Inboedel",
    "Omschrijving": "Woonhuis Teststraat 20 te Rotterdam",
    "OpdrachtId": "aaa54852-c447-4f04-8116-c89ac70a282f",
    "Pakketkorting": 2.84,
    "Premie": 15.53,
    "Soort": "Aanhangwagen",
    "SoortAanpassing": "Nieuw",
    "Status": "Nieuw",
    "TariefKenmerk": 0,
    "TariefNaam": "ASR Voordeelpakket"
  ]
}
```

--------------------------------

### CaravanProfiel JSON Example

Source: https://docs.voogd.com/docs/product-caravan

Example JSON payload for the CaravanProfiel object, showing all attributes including booleans, dates, strings, and nested arrays.

```json
{
	"AanrijdingMeeverzekeren": true,
	"Aanschafdatum": "2026-09-21T13:46:08Z",
	"BeschadigingMeeverzekeren": true,
	"Bouwdatum": "2026-09-21T13:46:08Z",
	"EersteEigenaar": true,
	"Geboortedatum": "2026-09-21T13:46:08Z",
	"GeboortedatumPartner": "2026-09-21T13:46:08Z",
	"GewensteTarieven": [
		{
			"TariefSoort": "string"
		}
	],
	"HagelMeeverzekeren": true,
	"HagelbestendigDak": true,
	"Id": "00000000-0000-0000-0000-000000000000",
	"InGebruikAlsStacaravan": true,
	"InclusiefSpecialeLimietTarieven": true,
	"Ingangsdatum": "2026-09-21T13:46:08Z",
	"Kenteken": "string",
	"Kinderen": [
		{
			"Geboortedatum": "2026-09-21T13:46:08Z"
		}
	],
	"Merknaam": "string",
	"Modelnaam": "string",
	"PermanentBewoond": true,
	"StormMeeverzekeren": true,
	"VerhuurMeeverzekeren": true
}
```
Tokens:
Raw