Skip to main content
API docs by Redocly

System API (1.0.0)

Download OpenAPI specification:Download

files

Upload a file

Upload a file

Authorizations:
jwt
Request Body schema: multipart/form-data
bucket
required
string
Enum: "images" "files"
type
required
string
Enum: "sample" "avatar" "weighbridge" "contract" "image" "logo" "misc" "vehicle" "terms-conditions" "trade-contract"

Name of the different file types in use (contract, sample etc)

file
required
Array of strings <binary>
name
required
string
organisationId
string
organisations
string

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "tags": [
    ],
  • "info": {
    },
  • "organisationId": "string",
  • "userId": "string",
  • "type": "string",
  • "status": "active"
}

Download a file

Download a file

Authorizations:
jwt
path Parameters
id
required
string

Id of the file to download

Responses

Response samples

Content type
application/json
{
  • "status": "string",
  • "message": "string",
  • "stack": "string",
  • "code": "string",
  • "body": { },
  • "validation": [
    ]
}

Delete file

Archives a file.

Authorizations:
jwt
path Parameters
id
required
string

Id of the file to download

Responses

Response samples

Content type
application/json
{
  • "status": "string",
  • "message": "string",
  • "stack": "string",
  • "code": "string",
  • "body": { },
  • "validation": [
    ]
}

Request file information

Request file information without downloading it

Authorizations:
jwt
path Parameters
id
required
string

Id of the file to download

Responses

Response samples

Content type
application/json
{
  • "bucket": "string",
  • "type": "sample",
  • "organisationId": "string",
  • "name": "string",
  • "hash": "string",
  • "contentType": "string",
  • "url": "string",
  • "userId": "string",
  • "userName": "string",
  • "organisations": [
    ],
  • "createdAtUTC": "string"
}

initialise

Retrieve system settings

Initial API to get required data for the client

Authorizations:
jwt

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Retrieve system settings

Initial API to get required data for the client

Authorizations:
jwt
path Parameters
country
required
string

Users country

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Cache

Get cache keys

Endpoint to get cache item

Authorizations:
jwt
query Parameters
key
required
string

Cache key

engine
string

Cache Engine

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Create cache

Endpoint to clear all or part of the cache

Authorizations:
jwt
Request Body schema: application/json
keys
Array of strings
prefixes
Array of strings
flush
boolean or null
Default: false
secrets
boolean or null
Default: false

Responses

Request samples

Content type
application/json
{
  • "keys": [
    ],
  • "prefixes": [
    ],
  • "flush": false,
  • "secrets": false
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Get cache keys

Endpoint to get cache keys

Authorizations:
jwt
query Parameters
prefix
required
string

Cache keys prefix

engine
string

Cache Engine

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

geo

Get supported countries

Returns a list of supported countries

Responses

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Get Location by What 3 Words

Get Location by What 3 Words

query Parameters
query
string

Free text search field for querying

Responses

Response samples

Content type
application/json
{
  • "what3words": "string",
  • "address": {
    },
  • "coordinates": {
    }
}

Get Location by Address Id

Get Location by Address Id

query Parameters
id
required
string

Id of the address to get details for

source
string

Source of the address search result

Responses

Response samples

Content type
application/json
{
  • "what3words": "string",
  • "address": {
    },
  • "coordinates": {
    }
}

Search addresses

Search for addresses and address containers

query Parameters
query
string

Free text search field for querying

id
string
countryISO
string

Filter by country

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "type": "string",
  • "text": "string",
  • "description": "string",
  • "source": "loqate"
}

Get Location by Coordinates

Get Location by Coordinates

query Parameters
lat
required
number

Latitude

lon
required
number

Longitude

Responses

Response samples

Content type
application/json
{
  • "what3words": "string",
  • "address": {
    },
  • "coordinates": {
    }
}

Get supported countries

Returns a list of supported countries

Responses

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Get Location by What 3 Words

Get Location by What 3 Words

query Parameters
query
string

Free text search field for querying

Responses

Response samples

Content type
application/json
{
  • "what3words": "string",
  • "address": {
    },
  • "coordinates": {
    }
}

Get Location by Address Id

Get Location by Address Id

query Parameters
id
required
string

Id of the address to get details for

source
string

Source of the address search result

Responses

Response samples

Content type
application/json
{
  • "what3words": "string",
  • "address": {
    },
  • "coordinates": {
    }
}

Search addresses

Search for addresses and address containers

query Parameters
query
string

Free text search field for querying

id
string
countryISO
string

Filter by country

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "type": "string",
  • "text": "string",
  • "description": "string",
  • "source": "loqate"
}

Get Location by Coordinates

Get Location by Coordinates

query Parameters
lat
required
number

Latitude

lon
required
number

Longitude

Responses

Response samples

Content type
application/json
{
  • "what3words": "string",
  • "address": {
    },
  • "coordinates": {
    }
}

countries

Get supported countries

Returns a list of supported countries

Responses

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Get supported countries

Returns a list of supported countries

Responses

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

what3words

Get Location by What 3 Words

Get Location by What 3 Words

query Parameters
query
string

Free text search field for querying

Responses

Response samples

Content type
application/json
{
  • "what3words": "string",
  • "address": {
    },
  • "coordinates": {
    }
}

Get Location by What 3 Words

Get Location by What 3 Words

query Parameters
query
string

Free text search field for querying

Responses

Response samples

Content type
application/json
{
  • "what3words": "string",
  • "address": {
    },
  • "coordinates": {
    }
}

address

Get Location by Address Id

Get Location by Address Id

query Parameters
id
required
string

Id of the address to get details for

source
string

Source of the address search result

Responses

Response samples

Content type
application/json
{
  • "what3words": "string",
  • "address": {
    },
  • "coordinates": {
    }
}

Search addresses

Search for addresses and address containers

query Parameters
query
string

Free text search field for querying

id
string
countryISO
string

Filter by country

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "type": "string",
  • "text": "string",
  • "description": "string",
  • "source": "loqate"
}

Get Location by Address Id

Get Location by Address Id

query Parameters
id
required
string

Id of the address to get details for

source
string

Source of the address search result

Responses

Response samples

Content type
application/json
{
  • "what3words": "string",
  • "address": {
    },
  • "coordinates": {
    }
}

Search addresses

Search for addresses and address containers

query Parameters
query
string

Free text search field for querying

id
string
countryISO
string

Filter by country

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "type": "string",
  • "text": "string",
  • "description": "string",
  • "source": "loqate"
}

coordinates

Get Location by Coordinates

Get Location by Coordinates

query Parameters
lat
required
number

Latitude

lon
required
number

Longitude

Responses

Response samples

Content type
application/json
{
  • "what3words": "string",
  • "address": {
    },
  • "coordinates": {
    }
}

Get Location by Coordinates

Get Location by Coordinates

query Parameters
lat
required
number

Latitude

lon
required
number

Longitude

Responses

Response samples

Content type
application/json
{
  • "what3words": "string",
  • "address": {
    },
  • "coordinates": {
    }
}

Country Regions

Get Country Regions

Returns a list regions based on the users country

query Parameters
countryISO
string

Filter by country

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "regions": [
    ]
}

Get Country Regions

Returns a list regions based on the users country

query Parameters
countryISO
string

Filter by country

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "regions": [
    ]
}

Hurl

Redirect the incoming URL

Redirect the incoming URL

path Parameters
id
required
string

Id of the resource

Responses

System System

Ping api

Ping system api

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Execute event

Execute event in system module

Authorizations:
jwt
path Parameters
action
required
string

Action to perform

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Update system settings

Change the system settings document in the system module

Authorizations:
jwt
Request Body schema: application/json
required
object
level
required
string
filter
required
string or null

Responses

Request samples

Content type
application/json
{
  • "logging": {
    }
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}