Payouts

Note

All calls require Authorization: Bearer <token> and API-key: <uuid>. The base URL is https://app.easyfreelance.no/api/v1 in production and https://test.easyfreelance.no/api/v1 in test. See Authentication.

The payout object

Field	Type	Description
`id`	`integer`	The payout ID.
`user_id`	`integer`	The contractor the payout applies to.
`invoice_id`	`integer` / `null`	The invoice the payout belongs to.
`status`	`string`	The state of the payout. Can be used as a filter on the list endpoints.
`type`	`string`	`payment` or `salary`.
`salary`	`string`	The salary base.
`vacation`	`string`	Statutory provision calculated from the salary base.
`pension`	`string`	Provision associated with the payout.
`net_salary`	`string`	Amount paid out after deductions.
`net_vacation`	`string`	Net provision.
`invoice_excl`	`string`	Invoice amount excluding VAT.
`invoice_incl`	`string`	Invoice amount including VAT.
`paid_at`	`date-time` / `null`	When the payout was completed.
`created_at`, `updated_at`	`date-time`	Timestamps.

Endpoints

POST/payouts

Create payouts

Creates one or more payouts that are collected on a single invoice to you. Each item in payouts must contain exactly one of user_id, phone or ssn.

Recommended

Send the header Idempotency-key with a valid UUID on this endpoint. You can then safely retry without risking duplicate payouts. See Idempotency.

Body

Field	Type		Description
`due_date`	`date`	required	The invoice due date.
`send_type`	`string`	optional	`Email` or `EHF`.
`payouts`	`array`	required	At least one item. The fields below apply per item.

Each item in payouts

Field	Type		Description
`type`	`string`	required	`payment` or `salary`.
`date`	`date`	required	The date the work was carried out.
`hours`	`number`	required	Number of hours.
`products`	`array`	required	At least one line item. See below.
`user_id`	`number`	optional	One of user_id / phone / ssn must be set.
`phone`	`string`	optional	Max 32 characters.
`ssn`	`string`	optional	Max 64 characters.
`description`	`string`	optional	Free text on the payout. Max 4096 characters.

Each item in products

Field	Type		Description
`quantity`	`number`	required	Quantity.
`price`	`number`	required	Unit price.
`description`	`string`	optional	Line item text on the invoice. Max 254 characters.

Example

POST /payouts

{
  "due_date": "2026-09-15",
  "send_type": "EHF",
  "payouts": [
    {
      "user_id": 123,
      "type": "salary",
      "date": "2026-08-28",
      "hours": 12,
      "description": "Produktfoto, uke 34",
      "products": [
        {
          "quantity": 12,
          "price": 1250,
          "description": "Fotografering per time"
        }
      ]
    }
  ]
}

Response

Code	Description
`201`	`{ "count": 1, "results": "..." }`
`400`	Validation error in `payouts`, or the idempotency key is invalid or has already been used.
`422`	Validation rejected by the framework.
`401`	Not authenticated.

GET/payouts

Retrieve all payouts

Paginated list of payouts for all contractors linked to your partner account.

Query parameters

Field	Type		Description
`status`	`string`	optional	Filter by status. Exact match.
`page`	`integer`	optional	Page number.
`page_size`	`integer`	optional	Items per page.

GET/users/{id}/payouts

Retrieve payouts for a single contractor

Paginated list of payouts for one specific contractor.

Parameters

Field	Type		Description
`id`	`integer`	required	User ID in the path.
`status`	`string`	optional	Filter by status. Exact match.

Response

Code	Description
`200`	Paginated envelope.
`404`	The user does not exist, or is not linked to your account.

GET/payouts/{payout}

Retrieve a single payout

Retrieves a single payout by ID.

Response

Code	Description
`200`	The payout object.
`403`	The payout belongs to another partner.
`404`	Not found.

POST/payouts/{payout}/login-link

Create a login link to the payout

Magic link that logs the contractor in and takes them straight to the page for this payout. Set send_email to true to send it by email.

Response

201 Created

{
  "login_url": "https://app.easyfreelance.no/magic/eyJ0eXAiOiJKV1Qi...",
  "expires_at": "2026-08-31T09:14:00+00:00"
}

Getting started

Flows

Reference

The payout object

Endpoints

Create payouts

Body

Each item in payouts

Each item in products

Example

Response

Retrieve all payouts

Query parameters

Retrieve payouts for a single contractor

Parameters

Response

Retrieve a single payout

Response