### GET /match-stages/ Request Example (Shell)

Source: https://developers.manatal.com/reference/match-stages

This snippet demonstrates how to make a GET request to the /match-stages/ endpoint using cURL. It includes the necessary URL and headers for authentication and content type.

```shell
curl --request GET \
     --url https://api.manatal.com/open/v3/match-stages/ \
     --header 'Authorization: Token ' \
     --header 'accept: application/json'
```

--------------------------------

### GET /match-stages/ Request Example (Ruby)

Source: https://developers.manatal.com/reference/match-stages

This snippet demonstrates fetching match stages using Ruby. It uses the Net::HTTP library to construct and send a GET request to the specified API endpoint.

```ruby
require 'net/http'
require 'uri'

uri = URI.parse("https://api.manatal.com/open/v3/match-stages/")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true # For HTTPS

request = Net::HTTP::Get.new(uri.request_uri)
request['Authorization'] = 'Token '
request['Accept'] = 'application/json'

response = http.request(request)
puts response.body
```

--------------------------------

### GET /match-stages/ Request Example (Python)

Source: https://developers.manatal.com/reference/match-stages

This snippet shows how to fetch match stages using Python. It utilizes the 'requests' library to send a GET request to the API endpoint with the specified headers.

```python
import requests

url = "https://api.manatal.com/open/v3/match-stages/"
headers = {
    "Authorization": "Token ",
    "Accept": "application/json"
}

response = requests.get(url, headers=headers)

print(response.json())
```

--------------------------------

### Retrieve All Users (Python)

Source: https://developers.manatal.com/reference/users

Python example using the 'requests' library to fetch user data. This snippet shows how to construct a GET request with authorization and accept headers. The API supports pagination.

```python
import requests

url = "https://api.manatal.com/open/v3/users/"

headers = {
    "Authorization": "Token ",
    "accept": "application/json"
}

response = requests.get(url, headers=headers)

print(response.json())
```

--------------------------------

### Retrieve All Users (PHP)

Source: https://developers.manatal.com/reference/users

PHP example using cURL to retrieve all users. This code demonstrates setting up a cURL request with GET method, URL, and required headers. Pagination is managed via query parameters.

```php
<?php

$curl = curl_init();

curl_setopt($curl, CURLOPT_URL, 'https://api.manatal.com/open/v3/users/');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_ENCODING, '');
curl_setopt($curl, CURLOPT_MAXREDIRS, 10);
curl_setopt($curl, CURLOPT_TIMEOUT, 0);
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($curl, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($curl, CURLOPT_HTTPHEADER, array(
  'Authorization: Token ',
  'accept: application/json'
));

$response = curl_exec($curl);

c_l_close($curl);

echo $response;
```

--------------------------------

### Retrieve All Users (Node.js)

Source: https://developers.manatal.com/reference/users

Node.js example using a fetch-like syntax to retrieve all users. This snippet demonstrates how to make a GET request to the users endpoint with necessary headers. Pagination is supported through query parameters.

```javascript
const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Token ',
    'accept': 'application/json'
  }
};

fetch('https://api.manatal.com/open/v3/users/', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(error => console.error(error));
```

--------------------------------

### GET /match-stages/ Request Example (Node.js)

Source: https://developers.manatal.com/reference/match-stages

This snippet shows how to retrieve match stages using Node.js. It utilizes the 'node-fetch' library to make a GET request to the API endpoint with appropriate headers.

```javascript
const fetch = require('node-fetch');

const url = "https://api.manatal.com/open/v3/match-stages/";
const options = {
    method: "GET",
    headers: {
        "Authorization": "Token ",
        "Accept": "application/json"
    }
};

fetch(url, options)
    .then(response => response.json())
    .then(json => console.log(json))
    .catch(err => console.error(err));
```

--------------------------------

### Retrieve Job Pipelines (Node.js)

Source: https://developers.manatal.com/reference/job-pipelines

Example using Node.js to fetch job pipelines from the Manatal API. This snippet demonstrates making a GET request with necessary headers.

```javascript
// Node.js example requires an HTTP client library like 'axios' or 'node-fetch'
// Assuming 'axios' is installed: npm install axios

const axios = require('axios');

const getJobPipelines = async () => {
  try {
    const response = await axios.get('https://api.manatal.com/open/v3/job-pipelines/', {
      headers: {
        'Authorization': 'Token ',
        'accept': 'application/json'
      }
    });
    console.log(response.data);
    return response.data;
  } catch (error) {
    console.error('Error fetching job pipelines:', error);
    throw error;
  }
};

getJobPipelines();
```

--------------------------------

### Get Currencies List - Ruby

Source: https://developers.manatal.com/reference/currencies

This Ruby snippet shows how to make a GET request to the /currencies/ endpoint to obtain a list of supported currencies. It uses the Net::HTTP library for making the HTTP request.

```ruby
require 'net/http'
require 'uri'

uri = URI.parse("https://api.manatal.com/open/v3/currencies/")
token = "YOUR_API_TOKEN"

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri.request_uri)
request['Authorization'] = "Token #{token}"
request['Accept'] = "application/json"

response = http.request(request)
puts response.body
```

--------------------------------

### Career Page API

Source: https://developers.manatal.com/reference/getting-started

This section describes technically how to integrate with the career page API.

```APIDOC
## Career Page API

### Description

This section provides technical details on how to integrate with the Manatal Career Page API.

### Method

All methods (GET, POST, PUT, DELETE) are supported.

### Endpoint

`https://api.manatal.com/open/v3/{ENDPOINT}`

### Parameters

#### Path Parameters

- **ENDPOINT** (string) - Required - The specific API endpoint for the career page.

#### Query Parameters

None specified.

#### Request Body

Depends on the specific endpoint being called.

### Request Example

```json
{
  "example": "Example request body depends on the specific career page endpoint"
}
```

### Response

#### Success Response (200)

- **data** (object) - The response data from the API.

#### Response Example

```json
{
  "example": "Example response body depends on the specific career page endpoint"
}
```
```

--------------------------------

### Get Currencies List - Node.js

Source: https://developers.manatal.com/reference/currencies

Example of how to retrieve the list of Manatal supported currencies using Node.js. This code utilizes the 'node-fetch' library to make an HTTP GET request.

```javascript
const fetch = require('node-fetch');

const url = "https://api.manatal.com/open/v3/currencies/";
const token = "YOUR_API_TOKEN";

fetch(url, {
  method: "GET",
  headers: {
    "Authorization": `Token ${token}`,
    "Accept": "application/json"
  }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));
```

--------------------------------

### Manatal Open API

Source: https://developers.manatal.com/reference/getting-started

This section describes technically how to integrate with the core Manatal API. To target these endpoints, you need to obtain a token from the support team.

```APIDOC
## Manatal Open API

### Description

This section details how to technically integrate with the core Manatal API. A token is required to access these endpoints.

### Method

All methods (GET, POST, PUT, DELETE) are supported.

### Endpoint

`https://api.manatal.com/open/v3/{ENDPOINT}`

### Parameters

#### Path Parameters

- **ENDPOINT** (string) - Required - The specific API endpoint you wish to access.

#### Query Parameters

None specified.

#### Request Body

Depends on the specific endpoint being called.

### Request Example

```json
{
  "example": "Example request body depends on the specific endpoint"
}
```

### Response

#### Success Response (200)

- **data** (object) - The response data from the API.

#### Response Example

```json
{
  "example": "Example response body depends on the specific endpoint"
}
```
```

--------------------------------

### GET /match-stages/ Request Example (PHP)

Source: https://developers.manatal.com/reference/match-stages

This snippet illustrates how to retrieve match stages using PHP. It uses cURL functions to perform a GET request to the API endpoint with the required headers.

```php
<?php

$curl = curl_init();

curl_setopt($curl, CURLOPT_URL, "https://api.manatal.com/open/v3/match-stages/");
curl_setopt($curl, CURLOPT_HTTPHEADER, array(
    "Authorization: Token ",
    "Accept: application/json"
));

$response = curl_exec($curl);

if (curl_errno($curl)) {
    echo 'Error:' . curl_error($curl);
}

course_close($curl);

echo $response;

?>
```

--------------------------------

### POST /candidates/{candidate_pk}/resume/

Source: https://developers.manatal.com/reference/candidates_resume_create

This endpoint allows you to upload a resume for a specific candidate. The resume can be in PDF, DOC, DOCX, or RTF format.

```APIDOC
## POST /candidates/{candidate_pk}/resume/

### Description
Uploads a resume for a specific candidate. The resume can be in PDF, DOC, DOCX, or RTF format.

### Method
POST

### Endpoint
/candidates/{candidate_pk}/resume/

### Parameters
#### Path Parameters
- **candidate_pk** (string) - Required - The primary key of the candidate for whom the resume is being uploaded.

#### Request Body
- **resume_file** (string) - Required - URL leading to the resume file. It can be of type pdf, doc, docx or rtf.

### Request Example
```json
{
  "resume_file": "https://example.com/path/to/your/resume.pdf"
}
```

### Response
#### Success Response (201)
- **id** (integer) - The unique identifier for the resume record.
- **resume_file** (string) - The URL of the uploaded resume file.
- **created_at** (string) - The date and time when the resume record was created.

#### Response Example
```json
{
  "id": 12345,
  "resume_file": "https://api.manatal.com/open/v3/media/candidates/123/resumes/resume.pdf",
  "created_at": "2023-10-27T10:00:00Z"
}
```
```

--------------------------------

### POST /jobs/

Source: https://developers.manatal.com/reference/jobs_create

Create a new job.

```APIDOC
## POST /jobs/

### Description
Create a new job.

### Method
POST

### Endpoint
/jobs/

### Parameters
#### Request Body
- **organization** (integer) - Required - Organization the job is assigned to
- **position_name** (string) - Required - Job title
- **external_id** (string) - Optional - Id of the job in the API consumer systems
- **description** (string) - Optional - Description of the job
- **headcount** (integer) - Optional - Number of people to be hired for the job
- **salary_min** (string) - Optional - Minimum salary
- **salary_max** (string) - Optional - Maximum salary
- **currency** (integer) - Optional - Currency ID
- **owner** (integer) - Optional - ID of the owner of the job
- **address** (string) - Optional - Address of the office the job will take place
- **zipcode** (string) - Optional - Code of the city for the address of the office
- **contract_details** (string) - Optional - Type of contract. Enum: "full_time", "part_time", "temporary", "freelance", "internship", "apprenticeship", "contractor", "consultancy"
- **is_published** (boolean) - Optional - Whether the job is published
- **is_remote** (boolean) - Optional - Whether the job is remote
- **status** (string) - Optional - Status of the job. Enum: "active"

### Request Example
```json
{
  "organization": 123,
  "position_name": "Software Engineer",
  "external_id": "JOB123",
  "description": "Develop and maintain web applications.",
  "headcount": 5,
  "salary_min": "100000.00",
  "salary_max": "120000.00",
  "currency": 1,
  "owner": 456,
  "address": "123 Main St",
  "zipcode": "94107",
  "contract_details": "full_time",
  "is_published": true,
  "is_remote": false,
  "status": "active"
}
```

### Response
#### Success Response (200)
- **id** (integer) - ReadOnly - ID of the job
- **external_id** (string) - ReadOnly - Id of the job in the API consumer systems
- **hash** (string) - ReadOnly - Unique hash of the candidate
- **organization** (integer) - Organization the job is assigned to
- **position_name** (string) - Job title
- **description** (string) - Description of the job
- **headcount** (integer) - Number of people to be hired for the job
- **creator** (integer) - ReadOnly - User who created the job
- **salary_min** (string) - Minimum salary
- **salary_max** (string) - Maximum salary
- **currency** (integer) - Currency ID
- **owner** (integer) - ID of the owner of the job
- **address** (string) - Address of the office the job will take place
- **zipcode** (string) - Code of the city for the address of the office
- **contract_details** (string) - Type of contract. Enum: "full_time", "part_time", "temporary", "freelance", "internship", "apprenticeship", "contractor", "consultancy"
- **is_published** (boolean) - Whether the job is published
- **is_remote** (boolean) - Whether the job is remote
- **status** (string) - Status of the job. Enum: "active"

#### Response Example
```json
{
  "id": 789,
  "external_id": "JOB123",
  "hash": "abcdef123456",
  "organization": 123,
  "position_name": "Software Engineer",
  "description": "Develop and maintain web applications.",
  "headcount": 5,
  "creator": 101,
  "salary_min": "100000.00",
  "salary_max": "120000.00",
  "currency": 1,
  "owner": 456,
  "address": "123 Main St",
  "zipcode": "94107",
  "contract_details": "full_time",
  "is_published": true,
  "is_remote": false,
  "status": "active"
}
```
```

--------------------------------

### Get Currencies List - PHP

Source: https://developers.manatal.com/reference/currencies

A PHP example for retrieving the list of currencies supported by Manatal. This code uses cURL to perform the GET request and includes necessary headers for authentication and content type.

```php
<?php

$url = "https://api.manatal.com/open/v3/currencies/";
$token = "YOUR_API_TOKEN";

$ch = curl_init($url);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Authorization: Token ' . $token,
    'Accept: application/json'
));

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}

curl_close($ch);

echo $response;

?>
```

--------------------------------

### Get Career Page Jobs (Shell/cURL)

Source: https://developers.manatal.com/reference/career-page

Example cURL request to fetch job listings from the Manatal API career page. This demonstrates the basic GET request structure and URL for the endpoint.

```shell
curl --request GET \
     --url https://api.manatal.com/open/v3/career-page/client_slug/jobs/
```

--------------------------------

### GET /candidates/{candidate_pk}/resume/

Source: https://developers.manatal.com/reference/candidates_resume_list

Retrieves a candidate's resume. If the resume is not in PDF format, it will be converted to PDF before being returned.

```APIDOC
## GET /candidates/{candidate_pk}/resume/

### Description
Retrieves a candidate's resume. If the resume is not in PDF format, it will be converted to PDF before being returned.

### Method
GET

### Endpoint
/candidates/{candidate_pk}/resume/

### Parameters
#### Path Parameters
- **candidate_pk** (string) - Required - The primary key of the candidate.

### Request Example
(No request body for GET request)

### Response
#### Success Response (200)
- **id** (integer) - Read-only ID of the resume entry.
- **resume_file** (string) - URL to the resume file (PDF, DOC, DOCX, or RTF).
- **created_at** (string) - Timestamp when the resume entry was created (date-time format).

#### Response Example
```json
[
  {
    "id": 123,
    "resume_file": "https://api.manatal.com/open/v3/media/resumes/candidate_123/resume.pdf",
    "created_at": "2023-10-27T10:00:00Z"
  }
]
```
```

--------------------------------

### Get Career Page Jobs (PHP)

Source: https://developers.manatal.com/reference/career-page

Example PHP code using cURL to fetch job listings from the Manatal API career page. This demonstrates how to make an HTTP GET request and retrieve the JSON response.

```php
<?php

$client_slug = 'your_client_slug'; // Replace with actual client slug
$url = "https://api.manatal.com/open/v3/career-page/{$client_slug}/jobs/";

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'Curl error: ' . curl_error($ch);
} else {
    // Process the JSON response
    $jobs = json_decode($response, true);
    print_r($jobs);
}

curl_close($ch);

?>
```

--------------------------------

### Retrieve Matches - Ruby

Source: https://developers.manatal.com/reference/matches-1

Ruby example using the 'net/http' library to make a GET request to the /matches/ endpoint. It configures the request with the necessary headers for authorization and content type.

```ruby
require 'net/http'
require 'uri'

uri = URI.parse("https://api.manatal.com/open/v3/matches/")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri.request_uri)
request['Authorization'] = 'Token '
request['accept'] = 'application/json'

response = http.request(request)

puts response.body
```

--------------------------------

### Retrieve All Users (Shell)

Source: https://developers.manatal.com/reference/users

Example cURL command to retrieve all users. It requires an Authorization header with a token and specifies the Accept header for JSON response. Supports pagination via 'page' and 'page_size' query parameters.

```shell
curl --request GET \
     --url https://api.manatal.com/open/v3/users/ \
     --header 'Authorization: Token ' \
     --header 'accept: application/json'
```

--------------------------------

### POST /candidates/

Source: https://developers.manatal.com/reference/candidates_create

Creates a new candidate. This endpoint allows for the addition of new candidate records into the system.

```APIDOC
## POST /candidates/

### Description
Creates a new candidate.

### Method
POST

### Endpoint
/candidates/

### Parameters
#### Request Body
- **name** (string) - Required - The name of the candidate.
- **email** (string) - Required - The email address of the candidate.
- **phone** (string) - Optional - The phone number of the candidate.

### Request Example
```json
{
  "name": "John Doe",
  "email": "john.doe@example.com",
  "phone": "123-456-7890"
}
```

### Response
#### Success Response (201)
- **id** (string) - The unique identifier of the newly created candidate.
- **name** (string) - The name of the candidate.
- **email** (string) - The email address of the candidate.
- **phone** (string) - The phone number of the candidate.

#### Response Example
```json
{
  "id": "cand_12345",
  "name": "John Doe",
  "email": "john.doe@example.com",
  "phone": "123-456-7890"
}
```
```

--------------------------------

### Retrieve Organizations (Ruby)

Source: https://developers.manatal.com/reference/organizations-1

This Ruby example uses the 'httparty' gem to make a GET request to the Manatal API. It configures the endpoint URL and includes headers for authentication and accepting JSON.

```ruby
require 'httparty'

url = 'https://api.manatal.com/open/v3/organizations/'

headers = {
  'Authorization' => 'Token ',
  'accept' => 'application/json'
}

response = HTTParty.get(url, headers: headers)

puts response.body
```

--------------------------------

### POST /candidates/

Source: https://developers.manatal.com/reference/candidates_create

Allows for the creation of a new candidate in the Manatal system. You can provide various details such as name, contact information, source, and consent status.

```APIDOC
## POST /candidates/

### Description
Create a new candidate.

### Method
POST

### Endpoint
/candidates/

### Parameters
#### Request Body
- **full_name** (string) - Required - Full name of the candidate
- **external_id** (string) - Optional - Id of the candidate in the API consumer systems
- **owner** (integer) - Optional - ID of the owner of the candidate - default to creator if none is provided
- **source_type** (string) - Optional - Origin of the candidate. Allowed values: "sourced", "applied", "referred", "agency", "other"
- **source_other** (string) - Optional - Field to add manual information to the source if the source_type is other
- **consent** (boolean) - Optional - Whether the candidate gave permission to use his data (GDPR,Brazil's LGPD, USA´s CCPA ...)
- **email** (string) - Optional - Candidate email
- **phone_number** (string) - Optional - Candidate phone number
- **gender** (string) - Optional - Gender of the candidate. Allowed values: "male", "female", "other", "unknown"
- **birth_date** (string) - Optional - Candidate birth date (format: YYYY-MM-DD)

### Request Example
```json
{
  "full_name": "John Doe",
  "external_id": "CAND123",
  "email": "john.doe@example.com",
  "phone_number": "+1234567890",
  "source_type": "sourced",
  "owner": 1,
  "consent": true
}
```

### Response
#### Success Response (201)
- **id** (integer) - Unique identifier for the created candidate.
- **external_id** (string) - External ID of the candidate.
- **full_name** (string) - Full name of the candidate.
- **creator** (integer) - User ID of the candidate's creator.
- **owner** (integer) - User ID of the candidate's owner.
- **source_type** (string) - Origin of the candidate.
- **source_other** (string) - Additional source information if source_type is 'other'.
- **consent** (boolean) - Consent status of the candidate.
- **consent_date** (string) - Date and time when consent was given (ISO 8601 format).
- **picture** (string) - URL to the candidate's picture.
- **email** (string) - Candidate's email address.
- **resume** (string) - URL to the candidate's resume.
- **phone_number** (string) - Candidate's phone number.
- **gender** (string) - Gender of the candidate.
- **birth_date** (string) - Candidate's birth date (format: YYYY-MM-DD).

#### Response Example
```json
{
  "id": 101,
  "external_id": "CAND123",
  "full_name": "John Doe",
  "creator": 1,
  "owner": 1,
  "source_type": "sourced",
  "source_other": null,
  "consent": true,
  "consent_date": "2023-10-27T10:00:00Z",
  "picture": "https://example.com/pictures/john_doe.jpg",
  "email": "john.doe@example.com",
  "resume": "https://example.com/resumes/john_doe.pdf",
  "phone_number": "+1234567890",
  "gender": "male",
  "birth_date": "1990-05-15"
}
```
```

--------------------------------

### Get Supported Languages via PHP

Source: https://developers.manatal.com/reference/languages

Demonstrates fetching supported languages from Manatal API using PHP with cURL. This example sets the necessary headers, including the Authorization token.

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.manatal.com/open/v3/languages/',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => [
    'Authorization: Token YOUR_API_TOKEN',
    'accept: application/json'
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error # " . $err;
} else {
  echo $response;
}
```

--------------------------------

### GET /candidates/

Source: https://developers.manatal.com/reference/candidates_list

Retrieves a list of all candidates. The candidates are returned in alphabetical order.

```APIDOC
## GET /candidates/

### Description
Retrieve all candidates ordered alphabetically.

### Method
GET

### Endpoint
/candidates/

### Parameters
#### Query Parameters

### Request Body

### Request Example

### Response
#### Success Response (200)
- **candidates** (array) - A list of candidate objects.
  - **name** (string) - The name of the candidate.
  - **id** (string) - The unique identifier of the candidate.

#### Response Example
```json
{
  "candidates": [
    {
      "name": "Alice Smith",
      "id": "candidate_123"
    },
    {
      "name": "Bob Johnson",
      "id": "candidate_456"
    }
  ]
}
```
```

--------------------------------

### Career Page API

Source: https://developers.manatal.com/reference

This section describes technically how to integrate with the career page api.

```APIDOC
## Career Page API

### Description
This section describes technically how to integrate with the career page api.

### Method
Not specified

### Endpoint
Not specified

### Parameters
Not specified

### Request Example
Not specified

### Response
Not specified

### Response Example
Not specified
```

--------------------------------

### Retrieve Job Pipelines (Python)

Source: https://developers.manatal.com/reference/job-pipelines

Python code to access the Manatal API for job pipelines. This example uses the 'requests' library to send a GET request with the necessary authorization and accept headers.

```python
import requests

url = "https://api.manatal.com/open/v3/job-pipelines/"
headers = {
    "Authorization": "Token ",
    "accept": "application/json"
}

try:
    response = requests.get(url, headers=headers)
    response.raise_for_status()  # Raise an exception for bad status codes (4xx or 5xx)
    print(response.json())
except requests.exceptions.RequestException as e:
    print(f"Error fetching job pipelines: {e}")
```

--------------------------------

### POST /websites/developers_manatal/career-page/{client_slug}/jobs/{id}/refer/

Source: https://developers.manatal.com/reference/career-page_jobs_refer_to_job

Retrieves or creates a candidate and refers them to a job.

```APIDOC
## POST /websites/developers_manatal/career-page/{client_slug}/jobs/{id}/refer/

### Description
Retrieves or creates a candidate object based on the provided email and adds them to the job as if the candidate is being referred by a third party.

### Method
POST

### Endpoint
/websites/developers_manatal/career-page/{client_slug}/jobs/{id}/refer/

### Parameters
#### Path Parameters
- **client_slug** (string) - Required - The slug of the client.
- **id** (string) - Required - The ID of the job.

#### Query Parameters
None

#### Request Body
- **email** (string) - Required - The email address of the candidate to refer.

### Request Example
```json
{
  "email": "candidate@example.com"
}
```

### Response
#### Success Response (200 or 201)
- **candidate_id** (string) - The ID of the created or retrieved candidate.
- **job_id** (string) - The ID of the job the candidate was referred to.
- **status** (string) - The referral status (e.g., "referred").

#### Response Example
```json
{
  "candidate_id": "cand_123abc",
  "job_id": "job_456def",
  "status": "referred"
}
```
```

--------------------------------

### Retrieve Job Pipelines (PHP)

Source: https://developers.manatal.com/reference/job-pipelines

A PHP example for fetching job pipelines from the Manatal API. This snippet uses cURL to make the GET request and includes the required headers for authentication and content type.

```php
<?php

$curl = curl_init();

curl_setopt($curl, CURLOPT_URL, 'https://api.manatal.com/open/v3/job-pipelines/');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Authorization: Token ',
    'accept: application/json'
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #" . $err;
} else {
  echo $response;
}

?>
```

--------------------------------

### Retrieve Candidates (Python)

Source: https://developers.manatal.com/reference/candidates-1

This Python example uses the 'requests' library to fetch candidate information. It constructs the request with the API endpoint, authorization token, and desired content type. The script handles the response, parsing JSON data or reporting any errors encountered during the request.

```python
import requests

url = "https://api.manatal.com/open/v3/candidates/"
headers = {
    'Authorization': 'Token <YOUR_TOKEN>',
    'accept': 'application/json'
}

try:
    response = requests.get(url, headers=headers)
    response.raise_for_status()  # Raise an exception for bad status codes
    data = response.json()
    print(data)
except requests.exceptions.RequestException as e:
    print(f"Error fetching candidates: {e}")
```

--------------------------------

### Get Supported Languages via Node.js

Source: https://developers.manatal.com/reference/languages

Example of fetching supported languages from Manatal API using Node.js. It utilizes the 'node-fetch' library for making HTTP requests. Requires an API token and handles JSON responses.

```javascript
const fetch = require('node-fetch');

const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Token YOUR_API_TOKEN',
    'accept': 'application/json'
  }
};

fetch('https://api.manatal.com/open/v3/languages/', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));
```

--------------------------------

### POST /organizations/

Source: https://developers.manatal.com/reference/organizations_create

Creates a new organization. This endpoint is used to register a new organization within the system.

```APIDOC
## POST /organizations/

### Description
Creates a new organization. This endpoint is used to register a new organization within the system.

### Method
POST

### Endpoint
/organizations/

### Parameters
#### Query Parameters
None

#### Request Body
- **name** (string) - Required - The name of the organization.
- **description** (string) - Optional - A brief description of the organization.

### Request Example
```json
{
  "name": "Example Corp",
  "description": "A sample organization for testing."
}
```

### Response
#### Success Response (201)
- **id** (string) - The unique identifier of the created organization.
- **name** (string) - The name of the organization.
- **description** (string) - The description of the organization.

#### Response Example
```json
{
  "id": "org_12345",
  "name": "Example Corp",
  "description": "A sample organization for testing."
}
```
```

--------------------------------

### GET /users/

Source: https://developers.manatal.com/reference/users_list

Retrieve all users ordered alphabetically. This endpoint supports pagination through 'page' and 'page_size' query parameters.

```APIDOC
## GET /users/

### Description
Retrieve all users ordered alphabetically.

### Method
GET

### Endpoint
https://api.manatal.com/open/v3/users/

### Parameters
#### Query Parameters
- **page** (integer) - Optional - A page number within the paginated result set.
- **page_size** (integer) - Optional - Number of results to return per page.

### Response
#### Success Response (200)
- **count** (integer) - The total number of users.
- **next** (string) - URL for the next page of results.
- **previous** (string) - URL for the previous page of results.
- **results** (array) - A list of user objects.
  - **id** (integer) - Unique identifier for the user.
  - **email** (string) - Email address of the user.
  - **full_name** (string) - Full name of the user.
  - **display_name** (string) - Name of the user to display.
  - **phone_number** (string) - Phone number of the user.
  - **picture** (string) - Link to the user's picture.

#### Response Example
```json
{
  "count": 10,
  "next": "https://api.manatal.com/open/v3/users/?page=2",
  "previous": null,
  "results": [
    {
      "id": 1,
      "email": "user1@example.com",
      "full_name": "User One",
      "display_name": "User One",
      "phone_number": "+1234567890",
      "picture": "https://api.manatal.com/media/pictures/user1.jpg"
    }
  ]
}
```
```

--------------------------------

### Get Career Page Jobs (Python)

Source: https://developers.manatal.com/reference/career-page

Example Python code using the 'requests' library to fetch job listings from the Manatal API career page. This snippet shows how to construct the URL and handle the JSON response.

```python
import requests

client_slug = "your_client_slug"  # Replace with actual client slug
url = f"https://api.manatal.com/open/v3/career-page/{client_slug}/jobs/"

try:
    response = requests.get(url)
    response.raise_for_status()  # Raise an exception for bad status codes
    jobs = response.json()
    print(jobs)
except requests.exceptions.RequestException as e:
    print(f"Error fetching jobs: {e}")
```

--------------------------------

### Get Career Page Jobs (Ruby)

Source: https://developers.manatal.com/reference/career-page

Example Ruby code using a hypothetical library to fetch job listings from the Manatal API career page. This snippet would require an HTTP client library like 'net/http' or 'httparty'.

```ruby
# Placeholder for Ruby example
# Requires an HTTP client library like net/http or httparty
# Example: require 'httparty'
#   response = HTTParty.get('https://api.manatal.com/open/v3/career-page/client_slug/jobs/')
#   puts response.parsed_response
```