Home AssignmentsFind freelance work InvoicingHow invoicing works PayoutsManage contractors SupportSupport and help
Country
Language
Create a free account

API/Terms

Reference

Terms

Retrieve the current terms and record whether the individual contractor has accepted them. This is one of the five onboarding steps.

Contents
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 terms object

FieldTypeDescription
codestring / nullCode for the current terms version.
titlestring / nullTitle that can be shown to the contractor.
urlstring / nullLink to the terms text itself.

Endpoints

GET/terms

Retrieve the current terms

Global metadata about the terms currently in force. Use these to show the correct version to the contractor before you record the acceptance.

Response

200 OK
{
  "terms": {
    "code": "2026-01",
    "title": "Vilkår for oppdragstakere",
    "url": "https://easyfreelance.no/vilkar"
  }
}
GET/users/terms

Same as GET /terms

Alias for GET /terms, retained for legacy integrations. New integrations should use GET /terms.

GET/users/{id}/terms

Retrieve acceptance status for a contractor

Shows whether the contractor has approved the current terms, and if so when.

Response

200 OK
{
  "user_id": "123",
  "terms_approved": true,
  "approved_at": "2026-08-14T09:02:11+00:00",
  "terms": {
    "code": "2026-01",
    "title": "Vilkår for oppdragstakere",
    "url": "https://easyfreelance.no/vilkar"
  }
}
POST/users/{id}/terms

Register acceptance

Sets whether the contractor has accepted the current terms. approved: true records the approval, false withdraws it. Updates the terms step in onboarding for the user.

Body

FieldTypeDescription
approvedbooleanrequiredtrue approves, false withdraws.

Response

200 OK
{
  "user_id": "123",
  "terms_approved": true,
  "approved_at": "2026-08-14T09:02:11+00:00",
  "terms": {
    "code": "2026-01",
    "title": "Vilkår for oppdragstakere",
    "url": "https://easyfreelance.no/vilkar"
  },
  "changed": true
}
Note

The field changed indicates whether the stored value was actually changed by this call. If you send the same value twice, you get changed false the second time.