niden API (v1)

Download OpenAPI specification:Download

Devices

Add device

Authorizations:

Bearer Token

Request Body schema: application/json

token

string

Responses

Request samples

Payload

Content type

application/json

{"token": "ade4564acd7da9186980929f1c10f759"
}

Response samples

422

Content type

application/json

{"error": {"code": "validation_error",
"details": [{"key": "token",
"message": "Token must be filled."
}
]
}
}

Access tokens

Get access token

Request Body schema: application/json

email required	string
refresh_token	string
password required	string
grant_type required	string

Responses

Request samples

Payload

Content type

application/json

Example

Obtain access token as user

{"email": "john.doe@example.com",
"password": "password",
"grant_type": "password"
}

Response samples

200
400

Content type

application/json

Example

when new access token is obtained by user

{"access_token": "WCkwUKbqnwG0hHwO7AFuj1ZYH8bKgeSFmo1-qf8WC6Q",
"token_type": "Bearer",
"expires_in": 43200,
"refresh_token": "UG76z226V0vY5UTZXFZBraKdQK4S818j3-1VlIH7BV4",
"created_at": 1788988132,
"user_id": 23
}

Revoke access token

Request Body schema: application/json

token

required

string

Responses

Request samples

Payload

Content type

application/json

{"token": "RMFTakb-8kWVknGmqAHsmvWrY_aUXpBc4N2-GdHOC6I"
}

General Files

Retrieves a list of general files

Authorizations:

Bearer Token

Responses

Response samples

200

Content type

application/json

[{"id": 3,
"name": "shared/2025_03.pdf",
"created_at": "2026-09-09T21:08:52.664509Z",
"file_url": "https://bucket.s3.region.amazonaws.com/shared/2025_03.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=access_key_id%2F20260909%2Fregion%2Fs3%2Faws4_request&X-Amz-Date=20260909T210852Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&X-Amz-Signature=885ceae8d71aa3b4fc0f0364821067ecd0b16a8ea337c9968268a4897587de9a"
},
{"id": 2,
"name": "shared/2025_02.pdf",
"created_at": "2026-09-09T21:08:52.662966Z",
"file_url": "https://bucket.s3.region.amazonaws.com/shared/2025_02.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=access_key_id%2F20260909%2Fregion%2Fs3%2Faws4_request&X-Amz-Date=20260909T210852Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&X-Amz-Signature=cf105b067ba9e2e63aab5f7d23b40f2d197b7b36f2461ac3bea47c21ceda66ef"
},
{"id": 1,
"name": "shared/2025_01.pdf",
"created_at": "2026-09-09T21:08:52.660337Z",
"file_url": "https://bucket.s3.region.amazonaws.com/shared/2025_01.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=access_key_id%2F20260909%2Fregion%2Fs3%2Faws4_request&X-Amz-Date=20260909T210852Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&X-Amz-Signature=c1b990f4a02211c270b131687c8ac9c5049e81161e46eaeb6b09af56a937073d"
}
]

Loyalty Programs

List Loyalty Programs

Authorizations:

Bearer Token

Responses

Response samples

200

Content type

application/json

[{"id": 1,
"name": "Thiel-Emard",
"description": "Quia sint qui. Omnis enim sed. Aut voluptatem ipsum.",
"bonus": 88,
"currency": "KZT",
"points_target": 2,
"requested_withdrawal": false,
"months_duration": 25,
"join_date": null,
"start_date": null,
"end_date": null,
"realization_date": null,
"failed": false,
"regulations": null,
"resigned": false,
"monthly_points": [{"month": "2026-09-04",
"points": 10
}
],
"is_withdrawal_visible": false
}
]

Join a Loyalty Program

Authorizations:

Bearer Token

Responses

Response samples

403
404
424

Content type

application/json

{"error": {"code": "validate_no_active_program",
"details": [{"key": "_base",
"message": "You already have an active loyalty program. You cannot join another program until you complete, resign from, or the current program expires."
}
]
}
}

Request a Loyalty Program bonus withdrawal

Authorizations:

Bearer Token

Request Body schema: application/json

program_id

required

integer

Responses

Request samples

Payload

Content type

application/json

{"program_id": 123
}

Response samples

404
422
424

Content type

application/json

{"error": {"code": "find_program",
"details": [{"key": "_base",
"message": "No avaiable loyalty program"
}
]
}
}

Loyality Programs

Resign a Loyality Program

Authorizations:

Bearer Token

Responses

Response samples

404
424

Content type

application/json

{"error": {"code": "validate_program_joined",
"details": [{"key": "_base",
"message": "No avaiable loyalty program"
}
]
}
}

Notifications

Get notifications

Authorizations:

Bearer Token

Responses

Response samples

200

Content type

application/json

[{"id": 5,
"title": "Klein Group",
"body": "Sunt a quia. Ut quis error. Dolores eligendi voluptas.",
"read": true,
"loyalty_program_id": null,
"created_at": "2026-09-10T00:08:53.363+02:00",
"notification_type": "referred_user_unrealised"
},
{"id": 3,
"title": "Trantow-Ankunding",
"body": "Quam dolore atque. Velit voluptatibus voluptas. Ad consequatur expedita.",
"read": false,
"loyalty_program_id": null,
"created_at": "2026-09-09T23:08:53.363+02:00",
"notification_type": "loyalty_program_resigned"
},
{"id": 6,
"title": "Schroeder LLC",
"body": "Pariatur ab et. Optio nihil officia. Soluta hic facere.",
"read": true,
"loyalty_program_id": null,
"created_at": "2026-09-09T23:08:53.363+02:00",
"notification_type": "loyalty_program_joined"
},
{"id": 4,
"title": "Wolff Group",
"body": "Quidem voluptatem autem. Adipisci temporibus odio. Sit fugiat cupiditate.",
"read": false,
"loyalty_program_id": null,
"created_at": "2026-09-09T22:08:53.363+02:00",
"notification_type": "referred_user_realised"
}
]

Updates notification

Authorizations:

Bearer Token

Responses

Get notification

Authorizations:

Bearer Token

path Parameters

id

required

string

Responses

Response samples

200
404
422

Content type

application/json

{"id": 15,
"title": "Jacobson, Abshire and Homenick",
"body": "Et aut commodi. Blanditiis reprehenderit commodi. Eius saepe exercitationem.",
"read": false,
"loyalty_program_id": null,
"created_at": "2026-09-09T23:08:53.448+02:00",
"notification_type": "loyalty_program_new"
}

Referred Users

Request a referral program bonus withdrawal

Authorizations:

Bearer Token

Request Body schema: application/json

referred_user_id required	integer
treshold_number required	integer Enum: 1 2

Responses

Request samples

Payload

Content type

application/json

{"referred_user_id": 123,
"treshold_number": 1
}

Response samples

403
404
422
424

Content type

application/json

{"error": {"code": "validate_achived_treshold",
"details": [{"key": "_base",
"message": "Requested threshold is not achieved yet."
}
]
}
}

User Files

Retrieves a list of user files

Authorizations:

Bearer Token

Responses

Response samples

200

Content type

application/json

[{"id": 3,
"name": "case_27_2025_03.pdf",
"created_at": "2026-09-09T21:08:53.660913Z",
"file_url": "https://bucket.s3.region.amazonaws.com/case_27_2025_03.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=access_key_id%2F20260909%2Fregion%2Fs3%2Faws4_request&X-Amz-Date=20260909T210853Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&X-Amz-Signature=d8b0c1d7a0d439b02a3844cb9bd3ea4e1f74b8d9b850fc387eb1d484d9d3b387"
},
{"id": 2,
"name": "case_27_2025_02.pdf",
"created_at": "2026-09-09T21:08:53.659247Z",
"file_url": "https://bucket.s3.region.amazonaws.com/case_27_2025_02.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=access_key_id%2F20260909%2Fregion%2Fs3%2Faws4_request&X-Amz-Date=20260909T210853Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&X-Amz-Signature=2231f84e6a8d9647ea209d1b89fb8148192d6b2fcd38babad1590e376a5b92d5"
},
{"id": 1,
"name": "case_27_2025_01.pdf",
"created_at": "2026-09-09T21:08:53.656242Z",
"file_url": "https://bucket.s3.region.amazonaws.com/case_27_2025_01.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=access_key_id%2F20260909%2Fregion%2Fs3%2Faws4_request&X-Amz-Date=20260909T210853Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&X-Amz-Signature=f73d0ada4fbf385f7edc3de0b9c491c0a9af10f96f5bb8d35783632a3e94bd89"
}
]

Users

Sends user job application

Request Body schema: application/json

email required	string
first_name required	string
last_name required	string
description	string
phone_number	string
city_or_region	string
referrer_case_id	string

Responses

Request samples

Payload

Content type

application/json

{"email": "string",
"first_name": "string",
"last_name": "string",
"description": "string",
"phone_number": "string",
"city_or_region": "string",
"referrer_case_id": "string"
}

Response samples

404
422
424

Content type

application/json

{"error": {"code": "validate_referrer_case_id",
"details": [{"key": "_base",
"message": "Referrer not found."
}
]
}
}

Retrieves a current user certificates data

Authorizations:

Bearer Token

Responses

Response samples

200

Content type

application/json

{"id": 77,
"employment_certificate_requested_at": null,
"employment_certificate_sent_at": null,
"income_certificate_requested_at": null,
"income_certificate_sent_at": null
}

Destroy user

Authorizations:

Bearer Token

path Parameters

id

required

string

Responses

Response samples

404
422
424

Content type

application/json

{"error": {"code": "fetch_user",
"details": [{"key": "_base",
"message": "Translation missing: en.errors.users.not_found"
}
]
}
}

Retrieves a current user details

Authorizations:

Bearer Token

Responses

Response samples

200

Content type

application/json

{"id": 85,
"employer": null,
"place_of_work": null,
"work_address": null,
"workplace_information": null,
"employment_type": null,
"employment_period": null,
"payroll_email": null,
"unpaid_leave_days": null,
"unpaid_leave_updated_at": null,
"absence_reports_phone_number": null,
"helpdesk_phone_number": null,
"job_coordinator_name": null,
"job_coordinator_email": null,
"job_coordinator_phone_number": null,
"accommodation_coordinator_name": null,
"accommodation_coordinator_email": null,
"accommodation_coordinator_phone_number": null,
"accommodation_address": null
}

Updates user's locale

Authorizations:

Bearer Token

Request Body schema: application/json

locale

required

string

Enum: "en" "pl" "uk" "ru"

Responses

Request samples

Payload

Content type

application/json

{"locale": "en"
}

Response samples

422

Content type

application/json

{"error": {"code": "validation_error",
"details": [{"key": "locale",
"message": "Language must be filled."
}
]
}
}

Retrieves a current user

Authorizations:

Bearer Token

Responses

Response samples

200

Content type

application/json

{"id": 93,
"first_name": null,
"last_name": null,
"email": "eulalia@ullrich.example",
"case_id": 40,
"device_id": null,
"onboarding_completed": true,
"referred_users": [ ]
}

Sends user employment certificate request

Authorizations:

Bearer Token

Request Body schema: application/json

period_from required	string <date> Okres od
period_to required	string <date> Okres do

Responses

Request samples

Payload

Content type

application/json

{"period_from": "2019-08-24",
"period_to": "2019-08-24"
}

Response samples

422
424

Content type

application/json

Example

validation error

{"error": {"code": "validation_error",
"details": [{"key": "period_from",
"message": "period_from must be filled."
},
{"key": "period_to",
"message": "period_to must be filled."
}
]
}
}

Sends user income certificate request

Authorizations:

Bearer Token

Request Body schema: application/json

period_from required	string <date> Okres od
period_to required	string <date> Okres do

Responses

Request samples

Payload

Content type

application/json

{"period_from": "2019-08-24",
"period_to": "2019-08-24"
}

Response samples

422
424

Content type

application/json

Example

validation error

{"error": {"code": "validation_error",
"details": [{"key": "period_from",
"message": "period_from must be filled."
},
{"key": "period_to",
"message": "period_to must be filled."
}
]
}
}

Resets user's current password

Request Body schema: application/json

email

required

string

Responses

Request samples

Payload

Content type

application/json

{"email": "john.doe@example.com"
}

Response samples

403
422

Content type

application/json

{"error": {"code": "validate_onboarding",
"details": [{"key": "_base",
"message": "To reset your password you have to pass onboarding. Contact Niden to get your welcome e-mail."
}
]
}
}

Sets new password for user

Request Body schema: application/json

token required	string
password required	string
password_confirmation required	string

Responses

Request samples

Payload

Content type

application/json

{"token": "3zttghdxh6yzp7tv1bh1w9hy",
"password": "Password100!",
"password_confirmation": "Password100!"
}

Response samples

422

Content type

application/json

Example

when no params

{"error": {"code": "validation_error",
"details": [{"key": "token",
"message": "Token must be filled."
},
{"key": "password",
"message": "Password must be filled."
},
{"key": "password_confirmation",
"message": "Password confirmation must be filled."
}
]
}
}