SAT Lima Vehicle Capture Orders

curl --request POST \
  --url https://api.croma.run/pe/sat-lima/capturas/v1 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "plate": "ABC123"
}
'

import requests

url = "https://api.croma.run/pe/sat-lima/capturas/v1"

payload = { "plate": "ABC123" }
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({plate: 'ABC123'})
};

fetch('https://api.croma.run/pe/sat-lima/capturas/v1', 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.croma.run/pe/sat-lima/capturas/v1",
  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([
    'plate' => 'ABC123'
  ]),
  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.croma.run/pe/sat-lima/capturas/v1"

	payload := strings.NewReader("{\n  \"plate\": \"ABC123\"\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.croma.run/pe/sat-lima/capturas/v1")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"plate\": \"ABC123\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.croma.run/pe/sat-lima/capturas/v1")

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  \"plate\": \"ABC123\"\n}"

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

{
  "data": {
    "found": true,
    "plate": "<string>",
    "has_capture_order": true,
    "message": "<string>",
    "report_date": "<string>",
    "orders": [
      {}
    ]
  }
}

{
  "job": {
    "id": "<string>",
    "status": "queued",
    "endpoint": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "finished_at": "2023-11-07T05:31:56Z",
    "status_url": "<string>"
  },
  "data": {},
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "details": {}
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "details": {}
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "details": {}
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "details": {}
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "details": {}
  }
}

SAT Lima Vehicle Capture Orders

Check whether a vehicle plate has an outstanding capture order (orden de captura) in the province of Lima, issued by the SAT de Lima (Servicio de Administración Tributaria de Lima) for unpaid tax debt or traffic tickets. has_capture_order: false means the plate has no capture order on record. When an order exists, orders lists each one with the fields the source reports.

Supports async delivery: set Prefer: wait=N for an inline result, pass callback_url to receive a POST when ready, or poll GET /jobs/{id}.

POST

sat-lima

capturas

SAT Lima Vehicle Capture Orders

curl --request POST \
  --url https://api.croma.run/pe/sat-lima/capturas/v1 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "plate": "ABC123"
}
'

import requests

url = "https://api.croma.run/pe/sat-lima/capturas/v1"

payload = { "plate": "ABC123" }
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({plate: 'ABC123'})
};

fetch('https://api.croma.run/pe/sat-lima/capturas/v1', 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.croma.run/pe/sat-lima/capturas/v1",
  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([
    'plate' => 'ABC123'
  ]),
  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.croma.run/pe/sat-lima/capturas/v1"

	payload := strings.NewReader("{\n  \"plate\": \"ABC123\"\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.croma.run/pe/sat-lima/capturas/v1")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"plate\": \"ABC123\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.croma.run/pe/sat-lima/capturas/v1")

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  \"plate\": \"ABC123\"\n}"

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

{
  "data": {
    "found": true,
    "plate": "<string>",
    "has_capture_order": true,
    "message": "<string>",
    "report_date": "<string>",
    "orders": [
      {}
    ]
  }
}

{
  "job": {
    "id": "<string>",
    "status": "queued",
    "endpoint": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "finished_at": "2023-11-07T05:31:56Z",
    "status_url": "<string>"
  },
  "data": {},
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "details": {}
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "details": {}
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "details": {}
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "details": {}
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "details": {}
  }
}

Authorizations

Authorization

string

header

required

Use Authorization: Bearer YOUR_API_KEY

Headers

Idempotency-Key

string

Optional client-chosen key for this request (any string up to 255 characters, e.g. a UUID). Every Croma operation is an idempotent lookup: repeating a request with the same body returns the same result and creates nothing, so retrying after a timeout or network failure is always safe. The key is echoed back in the Idempotency-Key response header so you can correlate a retry with its first attempt. Each attempt that reaches the API counts against the rate limit.

Maximum string length: 255

Example:

"0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b"

Prefer

string

Set wait=N to hold the connection up to N seconds for an inline result. If the job finishes in time you get the normal 200 body; otherwise a 202 with a status_url to poll.

Example:

"wait=30"

Body

application/json

plate

string

required

The vehicle plate to look up (4-10 characters).

Pattern: ^[A-Za-z0-9-]{4,10}$

callback_url

string<uri>

POST the job result here when it finishes.

Response

Successful response

data

object

required

Show child attributes

Overview

Countries

Jobs

SAT Lima Vehicle Capture Orders

Authorizations

Headers

Body

Response