Run with Postman
Documentation Powered by Redocly

Rintraccio posti di lavoro (1.0.0)

URL: https://openapi.it/en/support License: Apache 2.0 Terms of Service

This service allows you to check if a person is working for a specific company. The service is based on the Italian fiscal code and the company's tax code.

First time here? Generate a new access token

RPL

Get the list of your requests

Authorizations:
bearerAuth
    query Parameters
    status
    string
    Default: "<string>"
    Enum: "pending" "error" "completed"
    Example: status="completed"

    Filter for request status

    Responses

    Response Schema: application/json
    Array of objects[ items ]
    success
    boolean
    message
    string
    error
    string <nullable>

    Request samples 

    CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://rpl.openapi.it/request?status=SOME_STRING_VALUE");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

    Response samples

    Content type
    application/json
    {
    • "data": [
      ],
    • "success": true,
    • "message": "",
    • "error": null
    }

    Make a request

    Please note that this endpoint only accepts a single fiscal code

    Authorizations:
    bearerAuth
      Request Body schema: application/json
      required
      object (callback)
      fiscal_codes
      required
      Array of strings <= 2 items

      Valid Italan fiscal codes

      Responses

      Response Schema: application/json
      message
      string
      object
      success
      boolean
      error
      string <nullable>

      Callbacks

      Request samples

      Content type
      application/json
      Example
      Request with JSON callback
      Request with JSON callback
      Request with Form-Encoded callback
      {}

      Response samples

      Content type
      application/json
      {
      • "data": {
        },
      • "success": true,
      • "message": "",
      • "error": null
      }

      Callback payload samples

      Callback
      POST: Request completed
      Content type
      application/json
      {
      • "results": [
        ],
      • "status": "completed",
      • "request_id": "123123123123123"
      }

      Get a request by id

      Authorizations:
      bearerAuth
        path Parameters
        id
        required
        string
        Default: "<string>"

        The id of the request

        Responses

        Response Schema: application/json
        object
        success
        boolean
        message
        string
        error
        string <nullable>

        Request samples 

        CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://rpl.openapi.it/request/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

        Response samples

        Content type
        application/json
        Example
        completed
        completed
        pending
        {
        • "data": {
          }
        }

        Forcing a callback in the sandbox environment

        Please note that this endpoint is only available in the sandbox environment.

        Authorizations:
        bearerAuth
          path Parameters
          id
          required
          string
          Default: "<string>"

          The id of the request

          Responses

          Callbacks

          Request samples 

          CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://rpl.openapi.it/request/%7Bid%7D/callback");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

          Response samples

          Content type
          application/json
          {
          • "message": "Callback done with exit code: 200"
          }

          Callback payload samples

          Callback
          POST: Request completed
          Content type
          application/json
          {
          • "results": [
            ],
          • "status": "completed",
          • "request_id": "123123123123123"
          }

          Like POST /request, but accepts multiple fiscal codes

          Authorizations:
          bearerAuth
            Request Body schema: application/json
            required
            object (callback)
            fiscal_codes
            required
            Array of strings <= 2 items

            Valid Italan fiscal codes

            Responses

            Response Schema: application/json
            message
            string
            object
            success
            boolean
            error
            string <nullable>

            Callbacks

            Request samples

            Content type
            application/json
            Example
            Request with JSON callback
            Request with JSON callback
            Request with Form-Encoded callback
            {}

            Response samples

            Content type
            application/json
            {
            • "data": {
              },
            • "success": true,
            • "message": "",
            • "error": null
            }

            Callback payload samples

            Callback
            POST: Request completed
            Content type
            application/json
            {
            • "results": [
              ],
            • "status": "completed",
            • "request_id": "123123123123123"
            }