---
search:
  tags:
    - matters
    - PUT
seo:
  description: >-
    Create or update legal-aid (toevoeging) details for a matter (scope…
    Reference for the PUT /api/v1/matters/{id}/legal-aid endpoint in the Basenet
    Public API.
sidebar:
  label: >-
    Create or update legal-aid (toevoeging) details for a matter (scope
    billing:write; billing update required).
  badge: PUT
title: >-
  Create or update legal-aid (toevoeging) details for a matter (scope
  billing:write; billing update required).
type: openapi-operation
---
Endpoint: `PUT /api/v1/matters/{id}/legal-aid`

Authentication: `bearerAuth` (Scoped API token (bnx\_…). Required scopes are noted per operation.)

Parameters:
- `id` (in path, string, required)

Request body (`application/json`):
- `legalAidId` (string, optional)
- `makeActive` (boolean, optional)
- `boardRelationId` (string or null, optional)
- `legalAidNumber` (string or null, optional)
- `note` (string or null, optional)
- `type` (string or null, optional)
- `caseCategory` (string or null, optional)
- `points` (number or null, optional): Granted legal-aid points, represented to at most two decimal places.
- `basicChargeCents` (integer or null, optional)
- `travelTimeCents` (integer or null, optional)
- `travelCostCents` (integer or null, optional)
- `standardCostsCents` (integer or null, optional)
- `ownContributionCents` (integer or null, optional)
- `legalServicesReimbursementCents` (integer or null, optional)
- `dateRequested` (string or null, optional)
- `dateAssigned` (string or null, optional)
- `firstDecisionDate` (string or null, optional)
- `hourlyFrom` (string or null, required)
- `requireType` (boolean, optional)
- `clearLegacyToevoeging` (boolean, optional)

Responses:
- `200`: Saved legal-aid record
- `400`: Invalid request
- `401`: Unauthenticated
- `403`: Forbidden (missing scope or permission)
- `404`: Not found
- `429`: Rate limited

Response 200 body (`application/json`):
- `present` (boolean, required)
- `matterId` (string, required)
- `id` (string or null, required)
- `isActive` (boolean, required)
- `boardRelationId` (string or null, required)
- `legalAidNumber` (string or null, required)
- `note` (string or null, required)
- `type` (string or null, required)
- `caseCategory` (string or null, required)
- `points` (number or null, required): Granted legal-aid points, represented to at most two decimal places.
- `basicChargeCents` (integer or null, required)
- `travelTimeCents` (integer or null, required)
- `travelCostCents` (integer or null, required)
- `standardCostsCents` (integer or null, required)
- `ownContributionCents` (integer or null, required)
- `ownContributionInvoicedCents` (integer or null, required)
- `legalServicesReimbursementCents` (integer or null, required)
- `budgetCents` (integer or null, required)
- `dateRequested` (string or null, required)
- `dateAssigned` (string or null, required)
- `firstDecisionDate` (string or null, required)
- `hourlyFrom` (string or null, required)
- `continuesAsHoursMatter` (boolean, required): Deprecated: derived as hourlyFrom !== null. Prefer hourlyFrom for the dated switch.
- `createdAt` (string or null, required)
- `updatedAt` (string or null, required)
- `grants` (array of object, required)
- `grants[].id` (string, required)
- `grants[].isActive` (boolean, required)
- `grants[].boardRelationId` (string or null, required)
- `grants[].legalAidNumber` (string or null, required)
- `grants[].note` (string or null, required)
- `grants[].type` (string or null, required)
- `grants[].caseCategory` (string or null, required)
- `grants[].points` (number or null, required): Granted legal-aid points, represented to at most two decimal places.
- `grants[].basicChargeCents` (integer or null, required)
- `grants[].travelTimeCents` (integer or null, required)
- `grants[].travelCostCents` (integer or null, required)
- `grants[].standardCostsCents` (integer or null, required)
- `grants[].ownContributionCents` (integer or null, required)
- `grants[].ownContributionInvoicedCents` (integer or null, required)
- `grants[].legalServicesReimbursementCents` (integer or null, required)
- `grants[].dateRequested` (string or null, required)
- `grants[].dateAssigned` (string or null, required)
- `grants[].firstDecisionDate` (string or null, required)
- `grants[].hourlyFrom` (string or null, required)
- `grants[].createdAt` (string, required)
- `grants[].updatedAt` (string, required)