HR talent assessment report

POST /api/v3/reports/hr-screening

HR talent assessment report

cURL

curl --request POST \
  --url https://api.astrom8.com/api/v3/reports/hr-screening \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "candidate": {
    "birth_date": "1992-04-15",
    "timezoneOffsetMinutes": 420,
    "name": "<string>",
    "birth_time": "<string>",
    "latitude": 13.7563,
    "longitude": 100.5018
  },
  "position": "Senior Sales Manager",
  "outlook_years": 1,
  "include_pdf": false,
  "locale": "th"
}
'

import requests

url = "https://api.astrom8.com/api/v3/reports/hr-screening"

payload = {
    "candidate": {
        "birth_date": "1992-04-15",
        "timezoneOffsetMinutes": 420,
        "name": "<string>",
        "birth_time": "<string>",
        "latitude": 13.7563,
        "longitude": 100.5018
    },
    "position": "Senior Sales Manager",
    "outlook_years": 1,
    "include_pdf": False,
    "locale": "th"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    candidate: {
      birth_date: '1992-04-15',
      timezoneOffsetMinutes: 420,
      name: '<string>',
      birth_time: '<string>',
      latitude: 13.7563,
      longitude: 100.5018
    },
    position: 'Senior Sales Manager',
    outlook_years: 1,
    include_pdf: false,
    locale: 'th'
  })
};

fetch('https://api.astrom8.com/api/v3/reports/hr-screening', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.astrom8.com/api/v3/reports/hr-screening",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'candidate' => [
        'birth_date' => '1992-04-15',
        'timezoneOffsetMinutes' => 420,
        'name' => '<string>',
        'birth_time' => '<string>',
        'latitude' => 13.7563,
        'longitude' => 100.5018
    ],
    'position' => 'Senior Sales Manager',
    'outlook_years' => 1,
    'include_pdf' => false,
    'locale' => 'th'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.astrom8.com/api/v3/reports/hr-screening"

	payload := strings.NewReader("{\n  \"candidate\": {\n    \"birth_date\": \"1992-04-15\",\n    \"timezoneOffsetMinutes\": 420,\n    \"name\": \"<string>\",\n    \"birth_time\": \"<string>\",\n    \"latitude\": 13.7563,\n    \"longitude\": 100.5018\n  },\n  \"position\": \"Senior Sales Manager\",\n  \"outlook_years\": 1,\n  \"include_pdf\": false,\n  \"locale\": \"th\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.astrom8.com/api/v3/reports/hr-screening")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"candidate\": {\n    \"birth_date\": \"1992-04-15\",\n    \"timezoneOffsetMinutes\": 420,\n    \"name\": \"<string>\",\n    \"birth_time\": \"<string>\",\n    \"latitude\": 13.7563,\n    \"longitude\": 100.5018\n  },\n  \"position\": \"Senior Sales Manager\",\n  \"outlook_years\": 1,\n  \"include_pdf\": false,\n  \"locale\": \"th\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.astrom8.com/api/v3/reports/hr-screening")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"candidate\": {\n    \"birth_date\": \"1992-04-15\",\n    \"timezoneOffsetMinutes\": 420,\n    \"name\": \"<string>\",\n    \"birth_time\": \"<string>\",\n    \"latitude\": 13.7563,\n    \"longitude\": 100.5018\n  },\n  \"position\": \"Senior Sales Manager\",\n  \"outlook_years\": 1,\n  \"include_pdf\": false,\n  \"locale\": \"th\"\n}"

response = http.request(request)
puts response.read_body

200

{
  "request_id": "<string>",
  "generated_at": "2023-11-07T05:31:56Z",
  "position": "<string>",
  "candidate_summary": {},
  "bazi_profile": {},
  "thaksa_outlook": {},
  "company_fit": {},
  "position_match": {},
  "hr_narrative_th": "<string>",
  "hr_narrative_en": "<string>",
  "recommendation_score": 50,
  "recommendation_factors_th": "<string>",
  "recommendation_factors_en": "<string>",
  "pdf_url": "<string>",
  "expires_at": "2023-11-07T05:31:56Z"
}

{
  "error": "unauthorized",
  "message": "Invalid API key",
  "code": "401",
  "request_id": "01HQXYZ..."
}

{
  "error": "payment_required",
  "message": "Insufficient credits for this request",
  "code": "402",
  "request_id": "01HQXYZ..."
}

{
  "error": "<string>",
  "message": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

Authorizations

Authorization · string · header · required

Use the raw API key as the Bearer token, or send X-API-Key instead.

Body

application/json

candidate · object · required

Show child attributes

position · string · required

Required string length: 1 - 200

Example:

"Senior Sales Manager"

company · object

Show child attributes

outlook_years · integer · default: 1

Required range: 1 <= x <= 3

include_pdf · boolean · default: false

locale · enum<string> · default: th

Available options: th, en

Response

200

application/json

Structured HR talent assessment, with both Thai + English narratives and an optional 24h signed pdf_url when include_pdf=true.

request_id · string · required

generated_at · string<date-time> · required

position · string · required

candidate_summary · object · required

bazi_profile · object · required

thaksa_outlook · object · required

company_fit · object | null · required

position_match · object · required

hr_narrative_th · string · required

hr_narrative_en · string · required

recommendation · enum<string> · required

Available options: strong_hire, consider, caution, not_recommended

recommendation_score · integer · required

Required range: 0 <= x <= 100

recommendation_factors_th · string · required

recommendation_factors_en · string · required

pdf_url · string<uri>

expires_at · string<date-time>