Additional entity search

Production

https://api.polestar-production.com

GET

/purpletrac/v1/additional_entity_search

Search for additional entities by name, to be included in the vessel screening.

It will return any companies or people matching the provided name.

Note that only entities which appear on known watchlists will be returned in the results.

Request

Authorization

API Key

Add parameter in query

api_key

Example:

api_key: ********************

Query Params

Responses

🟢200OK

application/json

Entities whose name starts with your search term, each with the obj_id to pass when screening it. An empty objects list means the entity is on no watchlist.

Bodyapplication/json

🟠401Unauthorized

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.polestar-production.com/purpletrac/v1/additional_entity_search?username=undefined&limit=undefined&offset=undefined&name=undefined&api_key=%3Capi-key%3E'

Response Example

200 - Four matches

{
    "meta": {
        "limit": 20,
        "next": null,
        "offset": 0,
        "previous": null,
        "total_count": 4
    },
    "objects": [
        {
            "address_city": "Zagreb;;10000",
            "address_country": "CRTIA",
            "address_line": "Trnjanska cesta 5",
            "citizenship": null,
            "date_of_birth": null,
            "name": "Tesla Energenti",
            "obj_id": 11944745,
            "resident_of": null,
            "type": "organisation"
        },
        {
            "address_city": "Zagreb;;10000",
            "address_country": "CRTIA",
            "address_line": "Trnjanska cesta 5",
            "citizenship": null,
            "date_of_birth": null,
            "name": "Tesla Energenti za usluge i trgovinu",
            "obj_id": 11944745,
            "resident_of": null,
            "type": "organisation"
        },
        {
            "address_city": "Tehran",
            "address_country": "IRAN",
            "address_line": "No.15, Ground Floor, Abbasian Passage, After Hafez Bridge, Jomhouri St.",
            "citizenship": null,
            "date_of_birth": null,
            "name": "Tesla Hooshmand Sazan",
            "obj_id": 13388164,
            "resident_of": null,
            "type": "organisation"
        },
        {
            "address_city": "Tehran",
            "address_country": "IRAN",
            "address_line": "No.15, Ground Floor, Abbasian Passage, After Hafez Bridge, Jomhouri St.",
            "citizenship": null,
            "date_of_birth": null,
            "name": "Tesla Hooshmand Sazan Company",
            "obj_id": 13388164,
            "resident_of": null,
            "type": "organisation"
        }
    ]
}

Modified at 2026-09-18 08:35:54

Retrieve a list of vessels

Screening a vessel