billing
billing operations
GET /companies/billing[/:billing_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| priceId | integer | package price id which the client wants to book |
YES |
| userId | if priceId = 9, provide a user id for which the job assitent should be activated |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
{
"_links": {
"self": {
"href": "/companies/billing"
},
"first": {
"href": "/companies/billing?page={page}"
},
"prev": {
"href": "/companies/billing?page={page}"
},
"next": {
"href": "/companies/billing?page={page}"
},
"last": {
"href": "/companies/billing?page={page}"
}
}
"_embedded": {
"billing": [
{
"id": "billing id",
"paymentStatus": "payment status [pending, paid, canceled]",
"email": "company contact email",
"telephone": "company contact telephone number",
"companyName": "company name",
"companyNameBilling": "company billing name in case its different",
"streetBilling": "billing street",
"addressAdditional": "additional address info for billing address",
"zipcodeBilling": "billing zipcode",
"cityBilling": "billing city",
"countryBilling": "billing country",
"bill": "url path to billing document",
"price": "price",
"vat": "vat",
"vatId": "company's VAT ID",
"credits": "amount of credits",
"orderDateTime": {
"date": "2024-08-21 09:07:13.000000",
"timezone_type": 3,
"timezone": "Europe/Berlin"
},
"validFrom": {
"date": "2024-08-21 09:07:13.000000",
"timezone_type": 3,
"timezone": "Europe/Berlin"
},
"validTo": {
"date": "2025-08-21 09:07:13.000000",
"timezone_type": 3,
"timezone": "Europe/Berlin"
},
"_links": {
"self": {
"href": "http://localhost:8080/companies/billing/[:billing_id]"
}
}
}
]
}
}
POST /companies/billing[/:billing_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| priceId | integer | package price id which the client wants to book |
YES |
| userId | if priceId = 9, provide a user id for which the job assitent should be activated |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Content-Type | application/vnd.application-api.v1+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Body
{
"priceId": "package price id which the client wants to book"
}
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 400: Client Error
- 422: Unprocessable Entity
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
Chat
chat operations
GET /employee/[:employee_id]/chat[/:chat_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| message | text | message |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
POST /employee/[:employee_id]/chat[/:chat_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| message | text | message |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Content-Type | application/vnd.application-api.v1+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Body
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 400: Client Error
- 422: Unprocessable Entity
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
companiesJobapplicationEmployment
companies jobapplication employment operations
POST /companies/jobapplication/[:jobapplication_id]/employment[/:companies_jobapplication_employment_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| employmentStart | String | date string when employment starts |
NO |
| employmentExist | String | date string from when the emplyment status exists |
NO |
| employmentType | Bool | [limited, unlimeted] |
YES |
| professionalLicense | string | license type which is needed to work in offered position |
NO |
| overtimeObligation | Bool | [y, n] |
YES |
| overtimeExtend | String | to which extend is overtime obligated? |
NO |
| overtimeCompansation | String | how is the overtime compansated? |
NO |
| limitedEmploymentEnd | String | date string when limited employment ends |
NO |
| applicationId | integer | job application id for which the employment agreement is created |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Content-Type | application/vnd.application-api.v1+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Body
{
"employmentStart": "date string when employment starts",
"employmentExist": "date string from when the emplyment status exists",
"employmentType": "[limited, unlimeted]",
"professionalLicense": "license type which is needed to work in offered position",
"overtimeObligation": "[y, n]",
"overtimeExtend": "to which extend is overtime obligated?",
"overtimeCompansation": "how is the overtime compansated?",
"limitedEmploymentEnd": "date string when limited employment ends",
"applicationId": "job application id for which the employment agreement is created"
}
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 400: Client Error
- 422: Unprocessable Entity
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
GET /companies/jobapplication/[:jobapplication_id]/employment[/:companies_jobapplication_employment_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| employmentStart | String | date string when employment starts |
NO |
| employmentExist | String | date string from when the emplyment status exists |
NO |
| employmentType | Bool | [limited, unlimeted] |
YES |
| professionalLicense | string | license type which is needed to work in offered position |
NO |
| overtimeObligation | Bool | [y, n] |
YES |
| overtimeExtend | String | to which extend is overtime obligated? |
NO |
| overtimeCompansation | String | how is the overtime compansated? |
NO |
| limitedEmploymentEnd | String | date string when limited employment ends |
NO |
| applicationId | integer | job application id for which the employment agreement is created |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
companiesJobapplication
companiesJobapplication operations
GET /companies/[:joboffers_id]/jobapplication
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| joboffers_id | integer | joboffers id |
YES |
| status | string | application status |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
GET /companies/[:joboffers_id]/jobapplication[/:companies_jobapplication_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| joboffers_id | integer | joboffers id |
YES |
| status | string | application status |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
PATCH /companies/[:joboffers_id]/jobapplication[/:companies_jobapplication_id]
change the jobapplication status
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| joboffers_id | integer | joboffers id |
YES |
| status | string | application status |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Content-Type | application/vnd.application-api.v1+json
application/json |
Body
{
"status": "enum [preparing, pending, seen, ,approved, declined]"
}
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
- 400: Client Error
- 422: Unprocessable Entity
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
PUT /companies/[:joboffers_id]/jobapplication[/:companies_jobapplication_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| joboffers_id | integer | joboffers id |
YES |
| status | string | application status |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Content-Type | application/vnd.application-api.v1+json
application/json |
Body
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
- 400: Client Error
- 422: Unprocessable Entity
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
companiesJoboffers
companies job offers operations
GET /companies/joboffers
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| title | string | job offer title |
YES |
| description | string | YES | |
| jobPosition | string | NO | |
| jobOccupation | string | NO | |
| graduation | string | NO | |
| salary | string | NO | |
| thumbnail | binary | NO | |
| video | binary | NO | |
| applicant_characteristics_01 | integer | Organisationsfähigkeit |
NO |
| applicant_characteristics_02 | integer | Kreativität |
NO |
| applicant_characteristics_03 | integer | Geduld |
NO |
| applicant_characteristics_04 | integer | Kommunikationsfähigkeit |
NO |
| applicant_characteristics_05 | integer | Teamfähigkeit |
NO |
| languages | array | languages in which the job offer should be published |
NO |
| status | enum | [active, inactive] |
NO |
| facilityId | integer | the facilities ID to which the job offer belongs |
YES |
| languageWhish | string | additional language the customer whishes to add to the platform |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
POST /companies/joboffers
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| title | string | job offer title |
YES |
| description | string | YES | |
| jobPosition | string | NO | |
| jobOccupation | string | NO | |
| graduation | string | NO | |
| salary | string | NO | |
| thumbnail | binary | NO | |
| video | binary | NO | |
| applicant_characteristics_01 | integer | Organisationsfähigkeit |
NO |
| applicant_characteristics_02 | integer | Kreativität |
NO |
| applicant_characteristics_03 | integer | Geduld |
NO |
| applicant_characteristics_04 | integer | Kommunikationsfähigkeit |
NO |
| applicant_characteristics_05 | integer | Teamfähigkeit |
NO |
| languages | array | languages in which the job offer should be published |
NO |
| status | enum | [active, inactive] |
NO |
| facilityId | integer | the facilities ID to which the job offer belongs |
YES |
| languageWhish | string | additional language the customer whishes to add to the platform |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Content-Type | application/vnd.application-api.v1+json
application/json
multipart/form-data |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Body
{
"title": "job offer title",
"description": "",
"jobPosition": "",
"jobOccupation": "",
"graduation": "",
"salary": "",
"thumbnail": "",
"video": "",
"applicant_characteristics_01": "Organisationsfähigkeit",
"applicant_characteristics_02": "Kreativität",
"applicant_characteristics_03": "Geduld",
"applicant_characteristics_04": "Kommunikationsfähigkeit",
"applicant_characteristics_05": "Teamfähigkeit",
"languages": "languages in which the job offer should be published",
"languageWhish": "additional language the customer whishes to add to the platform"
"status": "[active, inactive]",
"facilityId": "the facilities ID to which the job offer belongs"
}
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 400: Client Error
- 422: Unprocessable Entity
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
GET /companies/joboffers[/:companies_joboffers_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| title | string | job offer title |
YES |
| description | string | YES | |
| jobPosition | string | NO | |
| jobOccupation | string | NO | |
| graduation | string | NO | |
| salary | string | NO | |
| thumbnail | binary | NO | |
| video | binary | NO | |
| applicant_characteristics_01 | integer | Organisationsfähigkeit |
NO |
| applicant_characteristics_02 | integer | Kreativität |
NO |
| applicant_characteristics_03 | integer | Geduld |
NO |
| applicant_characteristics_04 | integer | Kommunikationsfähigkeit |
NO |
| applicant_characteristics_05 | integer | Teamfähigkeit |
NO |
| languages | array | languages in which the job offer should be published |
NO |
| status | enum | [active, inactive] |
NO |
| facilityId | integer | the facilities ID to which the job offer belongs |
YES |
| languageWhish | string | additional language the customer whishes to add to the platform |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
PUT /companies/joboffers[/:companies_joboffers_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| title | string | job offer title |
YES |
| description | string | YES | |
| jobPosition | string | NO | |
| jobOccupation | string | NO | |
| graduation | string | NO | |
| salary | string | NO | |
| thumbnail | binary | NO | |
| video | binary | NO | |
| applicant_characteristics_01 | integer | Organisationsfähigkeit |
NO |
| applicant_characteristics_02 | integer | Kreativität |
NO |
| applicant_characteristics_03 | integer | Geduld |
NO |
| applicant_characteristics_04 | integer | Kommunikationsfähigkeit |
NO |
| applicant_characteristics_05 | integer | Teamfähigkeit |
NO |
| languages | array | languages in which the job offer should be published |
NO |
| status | enum | [active, inactive] |
NO |
| facilityId | integer | the facilities ID to which the job offer belongs |
YES |
| languageWhish | string | additional language the customer whishes to add to the platform |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Content-Type | application/vnd.application-api.v1+json
application/json
multipart/form-data |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Body
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
- 400: Client Error
- 422: Unprocessable Entity
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
companies
companies operations
GET /companies
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| accountPackage | enum | this is the payment package [starter_month, professional_month, professional_year] |
YES |
| companyName | string | YES | |
| ownerDepartment | string | department name in which the company owner works |
YES |
| ownerPosition | string | position in wich the company owner works |
YES |
| street | string | address |
YES |
| zipcode | string | address |
YES |
| city | string | address |
YES |
| country | string | address |
NO |
| companyNameBilling | string | company name on billing address |
YES |
| streetBilling | string | address |
YES |
| addressAdditional | string | additional address info for billing address |
NO |
| zipcodeBilling | string | address |
YES |
| cityBilling | string | address |
YES |
| vatId | string | company's VAT ID |
NO |
| amountEmployees | string | amount of employees working for company |
NO |
| amountFacilities | string | NO | |
| telephone | string | NO | |
| moreInfo | string | a short description about the company |
NO |
| domain | string | companies domain |
NO |
| logo | file | companies logo |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
POST /companies
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| accountPackage | enum | this is the payment package [starter_month, professional_month, professional_year] |
YES |
| companyName | string | YES | |
| ownerDepartment | string | department name in which the company owner works |
YES |
| ownerPosition | string | position in wich the company owner works |
YES |
| street | string | address |
YES |
| zipcode | string | address |
YES |
| city | string | address |
YES |
| country | string | address |
NO |
| companyNameBilling | string | company name on billing address |
YES |
| streetBilling | string | address |
YES |
| addressAdditional | string | additional address info for billing address |
NO |
| zipcodeBilling | string | address |
YES |
| cityBilling | string | address |
YES |
| vatId | string | company's VAT ID |
NO |
| amountEmployees | string | amount of employees working for company |
NO |
| amountFacilities | string | NO | |
| telephone | string | NO | |
| moreInfo | string | a short description about the company |
NO |
| domain | string | companies domain |
NO |
| logo | file | companies logo |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Content-Type | application/vnd.application-api.v1+json
application/json
multipart/form-data |
Body
{
"accountPackage": "this is the payment package [starter, professional_month, professional_year]",
"companyName": "",
"ownerDepartment": "department name in which the company owner works",
"ownerPosition": "position in wich the company owner works",
"employees": "amount of imployees working for company",
"street": "address",
"zipcode": "address",
"city": "address",
"country": "address",
"companyNameBillling": "company name on billing address",
"streetBilling": "address",
"addressAdditional": "additional address info for billing address",
"zipcodeBilling": "address",
"cityBilling": "address",
"vatId": "company's VAT ID"
}
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 400: Client Error
- 422: Unprocessable Entity
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
GET /companies[/:companies_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| accountPackage | enum | this is the payment package [starter_month, professional_month, professional_year] |
YES |
| companyName | string | YES | |
| ownerDepartment | string | department name in which the company owner works |
YES |
| ownerPosition | string | position in wich the company owner works |
YES |
| street | string | address |
YES |
| zipcode | string | address |
YES |
| city | string | address |
YES |
| country | string | address |
NO |
| companyNameBilling | string | company name on billing address |
YES |
| streetBilling | string | address |
YES |
| addressAdditional | string | additional address info for billing address |
NO |
| zipcodeBilling | string | address |
YES |
| cityBilling | string | address |
YES |
| vatId | string | company's VAT ID |
NO |
| amountEmployees | string | amount of employees working for company |
NO |
| amountFacilities | string | NO | |
| telephone | string | NO | |
| moreInfo | string | a short description about the company |
NO |
| domain | string | companies domain |
NO |
| logo | file | companies logo |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
PUT /companies[/:companies_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| accountPackage | enum | this is the payment package [starter_month, professional_month, professional_year] |
YES |
| companyName | string | YES | |
| ownerDepartment | string | department name in which the company owner works |
YES |
| ownerPosition | string | position in wich the company owner works |
YES |
| street | string | address |
YES |
| zipcode | string | address |
YES |
| city | string | address |
YES |
| country | string | address |
NO |
| companyNameBilling | string | company name on billing address |
YES |
| streetBilling | string | address |
YES |
| addressAdditional | string | additional address info for billing address |
NO |
| zipcodeBilling | string | address |
YES |
| cityBilling | string | address |
YES |
| vatId | string | company's VAT ID |
NO |
| amountEmployees | string | amount of employees working for company |
NO |
| amountFacilities | string | NO | |
| telephone | string | NO | |
| moreInfo | string | a short description about the company |
NO |
| domain | string | companies domain |
NO |
| logo | file | companies logo |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Content-Type | application/vnd.application-api.v1+json
application/json
multipart/form-data |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Body
{
"accountPackage": "this is the payment package [starter, professional_month, professional_year]",
"companyName": "",
"ownerDepartment": "department name in which the company owner works",
"ownerPosition": "position in wich the company owner works",
"amountEmployees": "amount of employees working for company",
"street": "address",
"zipcode": "address",
"city": "address",
"country": "address",
"companyNameBilling": "company name on billing address",
"streetBilling": "address",
"addressAdditional": "additional address info for billing address",
"zipcodeBilling": "address",
"cityBilling": "address",
"vatId": "company's VAT ID"
}
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
- 400: Client Error
- 422: Unprocessable Entity
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
DELETE /companies[/:companies_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| accountPackage | enum | this is the payment package [starter_month, professional_month, professional_year] |
YES |
| companyName | string | YES | |
| ownerDepartment | string | department name in which the company owner works |
YES |
| ownerPosition | string | position in wich the company owner works |
YES |
| street | string | address |
YES |
| zipcode | string | address |
YES |
| city | string | address |
YES |
| country | string | address |
NO |
| companyNameBilling | string | company name on billing address |
YES |
| streetBilling | string | address |
YES |
| addressAdditional | string | additional address info for billing address |
NO |
| zipcodeBilling | string | address |
YES |
| cityBilling | string | address |
YES |
| vatId | string | company's VAT ID |
NO |
| amountEmployees | string | amount of employees working for company |
NO |
| amountFacilities | string | NO | |
| telephone | string | NO | |
| moreInfo | string | a short description about the company |
NO |
| domain | string | companies domain |
NO |
| logo | file | companies logo |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 204: No Content
- 404: Not Found
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
POST /companies[/:companies_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| accountPackage | enum | this is the payment package [starter_month, professional_month, professional_year] |
YES |
| companyName | string | YES | |
| ownerDepartment | string | department name in which the company owner works |
YES |
| ownerPosition | string | position in wich the company owner works |
YES |
| street | string | address |
YES |
| zipcode | string | address |
YES |
| city | string | address |
YES |
| country | string | address |
NO |
| companyNameBilling | string | company name on billing address |
YES |
| streetBilling | string | address |
YES |
| addressAdditional | string | additional address info for billing address |
NO |
| zipcodeBilling | string | address |
YES |
| cityBilling | string | address |
YES |
| vatId | string | company's VAT ID |
NO |
| amountEmployees | string | amount of employees working for company |
NO |
| amountFacilities | string | NO | |
| telephone | string | NO | |
| moreInfo | string | a short description about the company |
NO |
| domain | string | companies domain |
NO |
| logo | file | companies logo |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Content-Type | application/vnd.application-api.v1+json
application/json
multipart/form-data |
Body
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 404: Not Found
- 400: Client Error
- 422: Unprocessable Entity
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
employees
employees operations
GET /companies/[:companies_id]/employees
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| string | employees email address |
YES | |
| role | enum | (hrAdmin, hrEmployee, employee) |
YES |
| facilityId | Array | facilities ID |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
POST /companies/[:companies_id]/employees
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| string | employees email address |
YES | |
| role | enum | (hrAdmin, hrEmployee, employee) |
YES |
| facilityId | Array | facilities ID |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Content-Type | application/vnd.application-api.v1+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Body
{
"email": ARRAY ["email-1", "email-2", "email-3"],
"role": ENUM (hrAdmin, hrEmployee, employee)",
"facilityId": ARRAY [id-1, id-2, id-3]
}
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 400: Client Error
- 422: Unprocessable Entity
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
DELETE /companies/[:companies_id]/employees
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| string | employees email address |
YES | |
| role | enum | (hrAdmin, hrEmployee, employee) |
YES |
| facilityId | Array | facilities ID |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 204: No Content
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
DELETE /companies/[:companies_id]/employees[/:employees_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| string | employees email address |
YES | |
| role | enum | (hrAdmin, hrEmployee, employee) |
YES |
| facilityId | Array | facilities ID |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 204: No Content
- 404: Not Found
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
GET /companies/[:companies_id]/employees[/:employees_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| string | employees email address |
YES | |
| role | enum | (hrAdmin, hrEmployee, employee) |
YES |
| facilityId | Array | facilities ID |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
facilities
facilities operations
GET /companies[/:companies_id]/facilities
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| facilityName | string | YES | |
| type | string | facility type [Kindergarten, Hort, Kita] |
NO |
| street | string | address |
YES |
| zipcode | string | address |
YES |
| city | string | address |
YES |
| country | string | address |
NO |
| amountEmployees | amount of employees working |
NO | |
| telephone | string | telephone number |
NO |
| string | email address |
NO | |
| logo | file | facility logo |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
POST /companies[/:companies_id]/facilities
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| facilityName | string | YES | |
| type | string | facility type [Kindergarten, Hort, Kita] |
NO |
| street | string | address |
YES |
| zipcode | string | address |
YES |
| city | string | address |
YES |
| country | string | address |
NO |
| amountEmployees | amount of employees working |
NO | |
| telephone | string | telephone number |
NO |
| string | email address |
NO | |
| logo | file | facility logo |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Content-Type | application/vnd.application-api.v1+json
application/json
multipart/form-data |
Body
{
"facilityName": "",
"type": "facility type [Kindergarten, Hort, Kita]",
"street": "address",
"zipcode": "address",
"city": "address",
"country": "address",
"amountEmployees": "amount of employees working",
"telephone": "telephone number",
"email": "email address",
"logo": "facility logo"
}
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 400: Client Error
- 422: Unprocessable Entity
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
GET /companies[/:companies_id]/facilities[/:facilities_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| facilityName | string | YES | |
| type | string | facility type [Kindergarten, Hort, Kita] |
NO |
| street | string | address |
YES |
| zipcode | string | address |
YES |
| city | string | address |
YES |
| country | string | address |
NO |
| amountEmployees | amount of employees working |
NO | |
| telephone | string | telephone number |
NO |
| string | email address |
NO | |
| logo | file | facility logo |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
PUT /companies[/:companies_id]/facilities[/:facilities_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| facilityName | string | YES | |
| type | string | facility type [Kindergarten, Hort, Kita] |
NO |
| street | string | address |
YES |
| zipcode | string | address |
YES |
| city | string | address |
YES |
| country | string | address |
NO |
| amountEmployees | amount of employees working |
NO | |
| telephone | string | telephone number |
NO |
| string | email address |
NO | |
| logo | file | facility logo |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Content-Type | application/vnd.application-api.v1+json
application/json
multipart/form-data |
Body
{
"facilityName": "",
"type": "facility type [Kindergarten, Hort, Kita]",
"street": "address",
"zipcode": "address",
"city": "address",
"country": "address",
"amountEmployees": "amount of employees working",
"telephone": "telephone number",
"email": "email address",
"logo": "facility logo"
}
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
- 400: Client Error
- 422: Unprocessable Entity
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
DELETE /companies[/:companies_id]/facilities[/:facilities_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| facilityName | string | YES | |
| type | string | facility type [Kindergarten, Hort, Kita] |
NO |
| street | string | address |
YES |
| zipcode | string | address |
YES |
| city | string | address |
YES |
| country | string | address |
NO |
| amountEmployees | amount of employees working |
NO | |
| telephone | string | telephone number |
NO |
| string | email address |
NO | |
| logo | file | facility logo |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 204: No Content
- 404: Not Found
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
jobFavorite
job favorite operations
GET /job-favorite
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| job_id | integer | job offers id |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
POST /job-favorite
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| job_id | integer | job offers id |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Content-Type | application/vnd.application-api.v1+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Body
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 400: Client Error
- 422: Unprocessable Entity
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
DELETE /job-favorite[/:job_favorite_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| job_id | integer | job offers id |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 204: No Content
- 404: Not Found
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
joboffersFeed
Job offers feed operations for fan-spaces companies
GET /joboffers-feed[/:joboffers_feed_id]
Retrieve job offers from fan-spaces companies with multi-language support
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
[
{
"id": 123,
"name": "Software Developer",
"link": "https://fan-spaces.best-places-to-work.com",
"region": "Bavaria, Berlin",
"description": "We are looking for an experienced software developer...",
"company": "FanSpaces GmbH",
"company_logo": "https://api.best-places-to-work.com/upload/companies/logos/FanSpaces+Logo.png",
"pubdate": "2024-01-15",
"updated": "2024-01-15",
"expire": "2025-01-15",
"jobtype": "Full-time, Part-time",
"salary": "€45,000 - €55,000 per year"
}
]
joboffers
job offers operations
GET /joboffers
show all or filter by company_id, facility_id, state=(url_encoded array), work_field(url_encoded array), position(url_encoded array), employment_type(url_encoded array) which job offers to show
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| title | string | job offer title |
YES |
| description | string | YES | |
| jobPosition | string | YES | |
| jobOccupation | string | YES | |
| graduation | string | NO | |
| salary | string | NO | |
| thumbnail | binary | NO | |
| video | binary | NO | |
| applicant_characteristics_01 | integer | Organisationsfähigkeit |
NO |
| applicant_characteristics_02 | integer | Kreativität |
NO |
| applicant_characteristics_03 | integer | Geduld |
NO |
| applicant_characteristics_04 | integer | Kommunikationsfähigkeit |
NO |
| applicant_characteristics_05 | integer | Teamfähigkeit |
NO |
| languages | array | languages in which the job offer should be published |
NO |
| status | enum | [active, inactive] |
NO |
| facility_id | integer | the facilities ID to which the job offer belongs |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
{
"_links": {
"self": {
"href": "/joboffers"
},
"first": {
"href": "/joboffers?page={page}"
},
"prev": {
"href": "/joboffers?page={page}"
},
"next": {
"href": "/joboffers?page={page}"
},
"last": {
"href": "/joboffers?page={page}"
}
}
"_embedded": {
"joboffers": [
{
"_links": {
"self": {
"href": "/joboffers[/:joboffers_id]"
}
}
"title": "job offer title",
"description": "",
"jobPosition": "",
"jobOccupation": "",
"graduation": "",
"salary": "",
"thumbnail": "",
"video": "",
"whatsAppQrCode": "opens whatsApp conversation -> set code in image src tag",
"whatsAppLink": "links to whatsApp conversation",
"applicant_characteristics_01": "Organisationsfähigkeit",
"applicant_characteristics_02": "Kreativität",
"applicant_characteristics_03": "Geduld",
"applicant_characteristics_04": "Kommunikationsfähigkeit",
"applicant_characteristics_05": "Teamfähigkeit",
"languages": "languages in which the job offer should be published",
"status": "[active, inactive]",
"facility_id": "the facilities ID to which the job offer belongs",
"locale": "current language",
"validTo"; "date till the joboffer is paid",
"profession": "enum: childcare, hotel, nursing, service",
"position": "enum: employee, trainee, freelancer, minijobber",
"employmentType: "enum: full, part",
"languageLevel": "enum: a1, a2, b1, b2, c1, c2",
"jobType": "enum: intern, extern",
"externUrl": "string: url to redirect in case jobType is extern"
}
]
}
}
GET /joboffers[/:joboffers_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| title | string | job offer title |
YES |
| description | string | YES | |
| jobPosition | string | YES | |
| jobOccupation | string | YES | |
| graduation | string | NO | |
| salary | string | NO | |
| thumbnail | binary | NO | |
| video | binary | NO | |
| applicant_characteristics_01 | integer | Organisationsfähigkeit |
NO |
| applicant_characteristics_02 | integer | Kreativität |
NO |
| applicant_characteristics_03 | integer | Geduld |
NO |
| applicant_characteristics_04 | integer | Kommunikationsfähigkeit |
NO |
| applicant_characteristics_05 | integer | Teamfähigkeit |
NO |
| languages | array | languages in which the job offer should be published |
NO |
| status | enum | [active, inactive] |
NO |
| facility_id | integer | the facilities ID to which the job offer belongs |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
UserOnboardingFiles
Deprecated: preg_replace(): Passing null to parameter #3 ($subject) of type array|string is deprecated in /var/www/vendor/michelf/php-markdown/Michelf/Markdown.php on line 233
GET /users/onboarding/files[/:user_onboarding_files_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| userId | int | user id |
YES |
| companyId | int | company id |
YES |
| file | binary | file |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
POST /users/onboarding/files[/:user_onboarding_files_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| userId | int | user id |
YES |
| companyId | int | company id |
YES |
| file | binary | file |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Content-Type | application/vnd.application-api.v1+json
application/json
multipart/form-data |
Body
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 400: Client Error
- 422: Unprocessable Entity
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
DELETE /users/onboarding/files[/:user_onboarding_files_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| userId | int | user id |
YES |
| companyId | int | company id |
YES |
| file | binary | file |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 204: No Content
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
usersJobapplicationFiles
users jobapplication files operations
GET /users/jobapplication/files
returns all user files
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| file | binary | application file |
YES |
| jobapplication_id | integer | job application id |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
{
"_links": {
"self": {
"href": "/users/jobapplication/files"
},
"first": {
"href": "/users/jobapplication/files?page={page}"
},
"prev": {
"href": "/users/jobapplication/files?page={page}"
},
"next": {
"href": "/users/jobapplication/files?page={page}"
},
"last": {
"href": "/users/jobapplication/files?page={page}"
}
}
"_embedded": {
"users_jobapplication_files": [
{
"id": fiel ID,
"link": "url link to file",
"file": {
"name": "file name without mime",
"mime": "file mime",
"nameMime": " file name with mime"
},
"createdDateTime": {
"date": "2024-08-29 11:39:37.000000",
"timezone_type": 3,
"timezone": "Europe/Berlin"
},
"_links": {
"self": {
"href": "/users/jobapplication/files[/:users_jobapplication_files_id]"
}
}
}
]
}
}
POST /users/jobapplication/files
uploads user files. If jobapplication_id is given, files will be attached to the specific job application
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| file | binary | application file |
YES |
| jobapplication_id | integer | job application id |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Content-Type | application/vnd.application-api.v1+json
application/json
multipart/form-data |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Body
{
"file": "application file",
"jobapplication_id": "job application id"
}
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 400: Client Error
- 422: Unprocessable Entity
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
GET /users/jobapplication/files[/:users_jobapplication_files_id]
returns a specific file
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| file | binary | application file |
YES |
| jobapplication_id | integer | job application id |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
DELETE /users/jobapplication/files[/:users_jobapplication_files_id]
deletes a specific file
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| file | binary | application file |
YES |
| jobapplication_id | integer | job application id |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 204: No Content
- 404: Not Found
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
usersJobapplication
users job applications operations
GET /users/jobapplication
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| firstname | string | users firstname |
NO |
| lastname | users lastname |
NO | |
| string | users email |
NO | |
| telephone | string | users telephone number |
NO |
| street | string | users street |
NO |
| zipcode | string | users zipcode |
NO |
| country | string | users country |
NO |
| nationality | string | users nationality |
NO |
| image | file | users image |
NO |
| joboffers_id | integer | joboffers id |
YES |
| graduation | users graduation |
NO | |
| description | text | text for cover letter |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
POST /users/jobapplication
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| firstname | string | users firstname |
NO |
| lastname | users lastname |
NO | |
| string | users email |
NO | |
| telephone | string | users telephone number |
NO |
| street | string | users street |
NO |
| zipcode | string | users zipcode |
NO |
| country | string | users country |
NO |
| nationality | string | users nationality |
NO |
| image | file | users image |
NO |
| joboffers_id | integer | joboffers id |
YES |
| graduation | users graduation |
NO | |
| description | text | text for cover letter |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Content-Type | application/vnd.application-api.v1+json
application/json
multipart/form-data |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Body
{
"firstname": "users firstname",
"lastname": "users lastname",
"email": "users email",
"telephone": "users telephone number",
"street": "users street",
"zipcode": "users zipcode",
"country": "users country",
"nationality": "users nationality",
"image": "users image",
"joboffers_id": "joboffers id",
"graduation": "users graduation",
"description": "text for cover letter"
}
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 400: Client Error
- 422: Unprocessable Entity
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
GET /users/jobapplication[/:users_jobapplication_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| firstname | string | users firstname |
NO |
| lastname | users lastname |
NO | |
| string | users email |
NO | |
| telephone | string | users telephone number |
NO |
| street | string | users street |
NO |
| zipcode | string | users zipcode |
NO |
| country | string | users country |
NO |
| nationality | string | users nationality |
NO |
| image | file | users image |
NO |
| joboffers_id | integer | joboffers id |
YES |
| graduation | users graduation |
NO | |
| description | text | text for cover letter |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
PUT /users/jobapplication[/:users_jobapplication_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| firstname | string | users firstname |
NO |
| lastname | users lastname |
NO | |
| string | users email |
NO | |
| telephone | string | users telephone number |
NO |
| street | string | users street |
NO |
| zipcode | string | users zipcode |
NO |
| country | string | users country |
NO |
| nationality | string | users nationality |
NO |
| image | file | users image |
NO |
| joboffers_id | integer | joboffers id |
YES |
| graduation | users graduation |
NO | |
| description | text | text for cover letter |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Content-Type | application/vnd.application-api.v1+json
application/json
multipart/form-data |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Body
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
- 400: Client Error
- 422: Unprocessable Entity
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
DELETE /users/jobapplication[/:users_jobapplication_id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| firstname | string | users firstname |
NO |
| lastname | users lastname |
NO | |
| string | users email |
NO | |
| telephone | string | users telephone number |
NO |
| street | string | users street |
NO |
| zipcode | string | users zipcode |
NO |
| country | string | users country |
NO |
| nationality | string | users nationality |
NO |
| image | file | users image |
NO |
| joboffers_id | integer | joboffers id |
YES |
| graduation | users graduation |
NO | |
| description | text | text for cover letter |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 204: No Content
- 404: Not Found
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
videoTranslation
Video Translation API Endpoint
GET /video-translation
Get list of video translations
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| video_id | integer | ID of the video to translate |
YES |
| target_language | string | Target language code for translation |
YES |
| status | enum | Translation status [pending, completed, failed] |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
{
"_links": {
"self": {
"href": "/video-translation"
}
},
"_embedded": {
"video_translation": [
{
"id": 1,
"video_id": 123,
"target_language": "es",
"status": "completed",
"_links": {
"self": {
"href": "/video-translation/1"
}
}
}
]
},
"total_items": 1,
"page_count": 1,
"page_size": 25,
"page": 1
}
POST /video-translation
Create a new video translation request
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| video_id | integer | ID of the video to translate |
YES |
| target_language | string | Target language code for translation |
YES |
| status | enum | Translation status [pending, completed, failed] |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Content-Type | application/vnd.application-api.v1+json
application/json
multipart/form-data |
Body
{
"video_id": 123,
"target_language": "es"
}
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 400: Client Error
- 422: Unprocessable Entity
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
{
"id": 1,
"video_id": 123,
"target_language": "es",
"status": "pending",
"_links": {
"self": {
"href": "/video-translation/1"
}
}
}
GET /video-translation[/:video_translation_id]
Get video translation details
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| video_id | integer | ID of the video to translate |
YES |
| target_language | string | Target language code for translation |
YES |
| status | enum | Translation status [pending, completed, failed] |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
{
"id": 1,
"video_id": 123,
"target_language": "es",
"status": "completed",
"_links": {
"self": {
"href": "/video-translation/1"
}
}
}
PUT /video-translation[/:video_translation_id]
Update video translation details
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| video_id | integer | ID of the video to translate |
YES |
| target_language | string | Target language code for translation |
YES |
| status | enum | Translation status [pending, completed, failed] |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Content-Type | application/vnd.application-api.v1+json
application/json
multipart/form-data |
Body
{
"status": "completed"
}
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
- 400: Client Error
- 422: Unprocessable Entity
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
{
"id": 1,
"video_id": 123,
"target_language": "es",
"status": "completed",
"_links": {
"self": {
"href": "/video-translation/1"
}
}
}
DELETE /video-translation[/:video_translation_id]
Delete a video translation
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| video_id | integer | ID of the video to translate |
YES |
| target_language | string | Target language code for translation |
YES |
| status | enum | Translation status [pending, completed, failed] |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/hal+json
application/json |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 204: No Content
- 404: Not Found
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/hal+json
application/json |
| Allow | Comma-separated list of all HTTP methods allowed |
accounting
accounting operations
GET /companies/accounting[/:id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| id | integer | accounting id |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/json
application/*+json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/json
application/*+json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
{
"booked": {
"starter": {
"name": "Starter Paket",
"0": {
"id": 1,
"title": "Starter Paket",
"price": "99,-€/Monat",
"validTo": "2025-09-12"
}
},
"joboffers": {
"name": "Stellenanzeigen",
"0": {
"id": 4,
"title": "Stellenanzeige",
"price": "99,-€/Monat",
"validTo": "2025-09-12"
},
"1": {
"id": 5,
"title": "Stellenanzeige",
"price": "99,-€/Monat",
"validTo": "2025-09-16"
},
"2": {
"id": 6,
"title": "Stellenanzeige",
"price": "99,-€/Monat",
"validTo": "2025-09-16"
}
},
"jobassistant": {
"name": "KI - Jobassistant",
"0": {
"id": 12,
"title": "KI - Jobassistant",
"price": "499,-€/Monat",
"validTo": "2025-09-16"
},
"1": {
"id": 15,
"title": "KI - Jobassistant",
"price": "499,-€/Monat",
"validTo": "2025-09-16"
}
}
}
}
DELETE /companies/accounting[/:id]
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| id | integer | accounting id |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/json
application/*+json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 204: No Content
- 404: Not Found
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/json
application/*+json |
| Allow | Comma-separated list of all HTTP methods allowed |
activateAssistant
activate assistant operations
POST /companies/activate/assistant
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| user | integer | user id |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/json
application/*+json |
| Content-Type | application/vnd.application-api.v1+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Body
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 404: Not Found
- 400: Client Error
- 422: Unprocessable Entity
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/json
application/*+json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
activateJoboffer
activate joboffer operations
POST /companies/activate/joboffer
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| joboffer | integer | joboffer id |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/json
application/*+json |
| Content-Type | application/vnd.application-api.v1+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Body
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 404: Not Found
- 400: Client Error
- 422: Unprocessable Entity
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/json
application/*+json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
ChatMode
chat mode operations
GET /employee/[:employee_id]/chat/mode
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| mode | boolean [ai, manual] | chat mode |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/json
application/*+json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/json
application/*+json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
PUT /employee/[:employee_id]/chat/mode
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| mode | boolean [ai, manual] | chat mode |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/json
application/*+json |
| Content-Type | application/vnd.application-api.v1+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Body
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
- 400: Client Error
- 422: Unprocessable Entity
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/json
application/*+json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
companiesPoll
poll operations
POST /companies/poll
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| companyId | integer | companyId |
YES |
| companiesWebsite | string | companies website |
NO |
| string | linked in profile name |
NO | |
| string | xing profile name |
NO | |
| stepstone | string | stepstone profile name |
NO |
| monster | string | monster profile name |
NO |
| eures | string | eures profile name |
NO |
| ihk | boolean | ihk account |
NO |
| ahk | boolean | ahk account |
NO |
| zav | boolean |
NO | |
| reprognition | boolean | reprognition account |
NO |
| wbsrecruiting | boolean | wbs recruiting account |
NO |
| scoutment | boolean | scoutment account |
NO |
| kofa | boolean | kofa account |
NO |
| bqportal | boolean | bq portal account |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/json
application/*+json |
| Content-Type | application/vnd.application-api.v1+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Body
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 404: Not Found
- 400: Client Error
- 422: Unprocessable Entity
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/json
application/*+json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
contact
contact operations
POST /contact
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| company | string | company name |
YES |
| name | string | sender lastname |
YES |
| firstname | string | senders firstname |
YES |
| string | senders email |
YES | |
| content | string | message content |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/json
application/*+json |
| Content-Type | application/vnd.application-api.v1+json
application/json |
Body
{
"company": "company name",
"name": "sender lastname",
"firstname": "senders firstname",
"email": "senders email",
"content": "message content"
}
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 404: Not Found
- 400: Client Error
- 422: Unprocessable Entity
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/json
application/*+json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
EmployeeOptin
employee optin operations
GET /employee/optin
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| id | integer | employee id |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/json
application/*+json |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/json
application/*+json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
joboffersCategories
joboffers categories operations
GET /joboffers/categories
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/json
application/*+json |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/json
application/*+json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
{
"profession": {
"childcare": "Kinderpflege",
"hotel": "Hotewl & Gastronomie",
"nursing": "(Kranken-)Pflege",
"service": "Hausdienstleistung"
},
"position": {
"employee": "Angestellter",
"trainee": "Auszubildener",
"freelancer": "Freelancer",
"minijobber": "Minijobber"
},
"imploymenttype": {
"full": "Vollzeit",
"part": "Teilzeit"
},
"languagelevel": {
"a1": "A1 - Anfänger",
"a2": "A2 - Grundlegende Kenntnisse",
"b1": "B1 - Fortgeschrittene Sprachverwendung",
"b2": "B2 - Selbstständinge Sprachkenntnisse",
"c1": "C1 - Fachkundige Sprachkenntnisse",
"c2": "C2 - Annähernd muttersprachliche Kenntnisse"
}
}
pricing
pricing operations
GET /pricing
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/json
application/*+json |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/json
application/*+json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
States
states operations
GET /states
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/json
application/*+json |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/json
application/*+json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
{
"baden_wuertenberg": "Baden Würtenberg",
"bayern": "Bayern",
"berlin": "Berlin",
"brandenburg": "Brandenburg",
"bremen": "Bremen",
"hamburg": "Hamburg",
"hessen": "Hessen",
"mecklenburg_vorpommern": "Mecklenburg-Vorpommern",
"niedersachsen": "Niedersachsen",
"nordrhein_westfalen": "Nordrhein-Westfalen",
"rheinland_pfalz": "Rheinland-Pfalz",
"saarland": "Saarland",
"sachsen_anhalt": "Sachsen-Anhalt",
"sachsen": "Sachsen",
"schleswig_holzstein": "Schleswig-Holzstein",
"thueringen": "Thüringen"
}
usersAccountPasswordCode
users account password reset operations
POST /users/account/password/code
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| string | users eMail address |
YES | |
| redirectUrl | string | redirect url on whci hthe user can set a new password and confirm the confirmation code |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/json
application/*+json |
| Content-Type | application/vnd.application-api.v1+json
application/json |
Body
{
"email": "users eMail address",
"redirectUrl": "redirect url on whci hthe user can set a new password and confirm the confirmation code"
}
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 404: Not Found
- 400: Client Error
- 422: Unprocessable Entity
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/json
application/*+json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
usersAccountPassword
users password operations
POST /users/account/password
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| password | string | users new password |
YES |
| confirmationCode | string | confirmation code to reset old password |
YES |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/json
application/*+json |
| Content-Type | application/vnd.application-api.v1+json
application/json |
Body
{
"password": "users new password",
"confirmationCode": "confirmation code to reset old password"
}
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 404: Not Found
- 400: Client Error
- 422: Unprocessable Entity
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/json
application/*+json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
usersAccount
users account operations
GET /users/account
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| firstname | string | users firstname |
NO |
| lastname | string | users lastname |
NO |
| string | users email |
NO | |
| password | string | users password |
NO |
| successRedirectUrl | string | redirect url after successfull opt-in |
NO |
| errorRedirectUrl | string | redirect url after failed op-on |
NO |
| notificationMessages | boolean | does the user allow for notification messages? |
NO |
| telephone | string | users telephone number |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/json
application/*+json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/json
application/*+json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
{
"firstname": "users firstname",
"lastname": "users lastname",
"email": "users email",
"telephone": "users telephonenumber",
"password": "users password",
"successRedirectUrl": "redirect url after successfull opt-in",
"errorRedirectUrl": "redirect url after failed op-on",
"notificationMessages": "does the user allow for notification messages?"
}
PUT /users/account
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| firstname | string | users firstname |
NO |
| lastname | string | users lastname |
NO |
| string | users email |
NO | |
| password | string | users password |
NO |
| successRedirectUrl | string | redirect url after successfull opt-in |
NO |
| errorRedirectUrl | string | redirect url after failed op-on |
NO |
| notificationMessages | boolean | does the user allow for notification messages? |
NO |
| telephone | string | users telephone number |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/json
application/*+json |
| Content-Type | application/vnd.application-api.v1+json
application/json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Body
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 200: OK
- 404: Not Found
- 400: Client Error
- 422: Unprocessable Entity
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/json
application/*+json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
DELETE /users/account
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| firstname | string | users firstname |
NO |
| lastname | string | users lastname |
NO |
| string | users email |
NO | |
| password | string | users password |
NO |
| successRedirectUrl | string | redirect url after successfull opt-in |
NO |
| errorRedirectUrl | string | redirect url after failed op-on |
NO |
| notificationMessages | boolean | does the user allow for notification messages? |
NO |
| telephone | string | users telephone number |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/json
application/*+json |
| Authorization | HTTP Basic, HTTP Digest, or OAuth2 Bearer token (check API provider for details) |
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 204: No Content
- 404: Not Found
- 401: Unauthorized
- 403: Forbidden
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/json
application/*+json |
| Allow | Comma-separated list of all HTTP methods allowed |
POST /users/account
Fields
| Field | Type | Description | Required |
|---|---|---|---|
| firstname | string | users firstname |
NO |
| lastname | string | users lastname |
NO |
| string | users email |
NO | |
| password | string | users password |
NO |
| successRedirectUrl | string | redirect url after successfull opt-in |
NO |
| errorRedirectUrl | string | redirect url after failed op-on |
NO |
| notificationMessages | boolean | does the user allow for notification messages? |
NO |
| telephone | string | users telephone number |
NO |
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/json
application/*+json |
| Content-Type | application/vnd.application-api.v1+json
application/json |
Body
{
"firstname": "users firstname",
"lastname": "users lastname",
"email": "users email",
"password": "users password",
"successRedirectUrl": "redirect url after successfull opt-in",
"errorRedirectUrl": "redirect url after failed op-on"
}
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 404: Not Found
- 400: Client Error
- 422: Unprocessable Entity
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/json
application/*+json |
| Allow | Comma-separated list of all HTTP methods allowed |
Body
{
"firstname": "users firstname",
"lastname": "users lastname",
"email": "users email",
"successRedirectUrl": "redirect url after successfull opt-in",
"errorRedirectUrl": "redirect url after failed op-on"
}
Webhook
Deprecated: preg_replace(): Passing null to parameter #3 ($subject) of type array|string is deprecated in /var/www/vendor/michelf/php-markdown/Michelf/Markdown.php on line 233
POST /webhook
Request
Headers
| Header | Value |
|---|---|
| Accept | application/vnd.application-api.v1+json
application/json
application/*+json |
| Content-Type | application/vnd.application-api.v1+json
application/json |
Body
Response
Status Codes
- 406: Not Acceptable
- 415: Unsupported Media Type
- 201: Created
- 404: Not Found
Headers
| Header | Value |
|---|---|
| Content-Type | application/vnd.application-api.v1+json
application/json
application/*+json |
| Allow | Comma-separated list of all HTTP methods allowed |