Skip to the content

adr dangerous goods Api

With the ADR (dangerous goods) API you will be able to include the dangerous goods table in your own application and always have the latest ADR table at hand.

Reinder.eu offers a simple JSON based REST API service developed to consult and analyze the dangerous goods table.

The following API documentation is meant to describe in detail the specifications and features of the API.

Have a try with propane gas: https://address.whacky.nl/api/adr/query?api_key=8ADD9919-E715-414C-B592-137253CE85AA&un_number=1978

Using the API

If you would like to use the ADR API in your application, please apply for an API key by filling out the form below. The Dangerous goods API is free to use up to 10 requests per month. If you would like to implement more requests per month or link the API to your own application, the costs are €10,- per month for up to 10,000 requests per month.

For larger volumes ask for a quote.

API Key and authentication

After registration you will receive a personal access key, which gives you access to all API Endpoints you subscribed for. You can use the http GET method for all API Endpoints.

https://address.whacky.nl/api/adr/query?api_key=8ADD9919-E715-414C-B592-137253CE85AA

With the API_KEY 8ADD9919-E715-414C-B592-137253CE85AA you will be able to perform 10 guest requests per month.

API Endpoints

The endpoint address for the ADR (dangerous goods) API is:

https://address.whacky.nl/api/adr

API Error Codes

The validation status will be returned in all API Endpoints. The validation status contains the following data:

Validation code: Unique identification of the status

Validation info: System name of the validation report

Validation description: detailed description of the validation report

The following reports can be returned:

1001: ok: Validation successful, no errors found

1002: ok_with_warnings: Validation recognized, but not completed

1003: not_valid: Validation errors, UN number not recognized

2001: missing_access_key: The API key is missing from your request

2002: invalid_access_key: Invalid API key

2003: invalid_api_function: The function you are trying to use is invalid. Consult the documentation.

2004: usage_limit_reached: You have reached the limit of your subscription.

2005: function_access_restricted: Your subscription does not allow the request

4004: 404_not_found: You have sent an invalid request, which cannot be found

ADR (dangerous goods) API request

Parameters

  • API key (mandatory): personal access key to access the data base
  • UN number (mandatory): the UN number integer or with leading zeroes

Retrieve ADR (dangerous goods) data based on the UN number

https://address.whacky.nl/api/adr/query?

api_key=8ADD9919-E715-414C-B592-137253CE85AA&

un_number=0006

API Response

Below you will find a statement of the properties in the API Response. The statement refers to European Agreement Concerning the International Carriageof Dangerous Goods by Road.

A code is included in every header. This code refers to a chapter in above document.

The full text of the explanation below is available on the website https://adrbook.com

Column (1) “UN-number”

 Contains the UN number:
- of the dangerous substance or article if the substance or article has been
assigned its own specific UN number; or
- of the generic or n.o.s. entry to which the dangerous substances or articles
not mentioned by name shall be assigned in accordance with the criteria
("decision trees") of Part 2.

Column 2 Proper Shipping Name (Name + Description)

Contains, in upper case characters, the name of the substance or article, if the
substance or article has been assigned its own specific UN number, or of the
generic or n.o.s. entry to which it has been assigned in accordance with the
criteria ("decision trees") of Part 2. This name shall be used as the proper
shipping name or, when applicable, as part of the proper shipping name
(see 3.1.2 for further details on the proper shipping name).
A descriptive text in lower case characters is added after the proper shipping
name to clarify the scope of the entry if the classification and/or carriage
conditions of the substance or article may be different under certain conditions.
Column (3a) "Class"
Contains the number of the class, whose heading covers the dangerous substance or
article. This class number is assigned in accordance with the procedures and criteria
of Part 2.

Column 3(a) Class Code 2.2

Contains the classification code of the dangerous substance or article.
- For dangerous substances or articles of Class 1, the code consists of a
division number and compatibility group letter, which are assigned in
accordance with the procedures and criteria of 2.2.1.1.4;
- For dangerous substances or articles of Class 2, the code consists of a
number and hazardous property group, which are explained in 2.2.2.1.2 and
2.2.2.1.3;
- For dangerous substances or articles of Classes 3, 4.1, 4.2, 4.3, 5.1, 5.2, 6.1,
6.2, 8 and 9, the codes are explained in 2.2.x.1.2 1;
- Dangerous substances or articles of Class 7 do not have a classification code.

Column (3b) "Classification code"

Contains the classification code of the dangerous substance or article.
- For dangerous substances or articles of Class 1, the code consists of a
division number and compatibility group letter, which are assigned in
accordance with the procedures and criteria of 2.2.1.1.4;
- For dangerous substances or articles of Class 2, the code consists of a
number and hazardous property group, which are explained in 2.2.2.1.2 and
2.2.2.1.3;
- For dangerous substances or articles of Classes 3, 4.1, 4.2, 4.3, 5.1, 5.2, 6.1,
6.2, 8 and 9, the codes are explained in 2.2.x.1.2 1;
- Dangerous substances or articles of Class 7 do not have a classification code.

Column (4) "Packing group"

Contains the packing group number(s) (I, II or III) assigned to the dangerous
substance. These packing group numbers are assigned on the basis of the
procedures and criteria of Part 2. Certain articles and substances are not assigned to
packing groups.

Column (5) "Labels"

Contains the model number of the labels/placards (see 5.2.2.2 and 5.3.1.7) that have
to be affixed to packages, containers, tank-containers, portable tanks, MEGCs and
vehicles. However, for substances or articles of Class 7, 7X means label model
No.7A, 7B or 7C as appropriate according to the category (see 5.1.5.3.4 and
5.2.2.1.11.1) or placard No. 7D (see 5.3.1.1.3 and 5.3.1.7.2).
The general provisions on labelling/placarding (e.g. number of labels, their location)
are to be found in 5.2.2.1 for packages, and in 5.3.1, for containers, tank-containers,
MEGCs, portable tanks and vehicles.
NOTE: Special provisions, indicated in Column (6), may change the above
labelling provisions.

Column (6) "Special provisions"

Contains the numeric codes of special provisions that have to be met. These
provisions concern a wide array of subjects, mainly connected with the contents of
Columns (1) to (5) (e.g. carriage prohibitions, exemptions from requirements,
explanations concerning the classification of certain forms of the dangerous goods
concerned and additional labelling or marking provisions), and are listed in Chapter
3.3 in numerical order. If Column (6) is empty, no special provisions apply to the
contents of Columns (1) to (5) for the dangerous goods concerned.

Column (7a) "Limited Quantities"

Provides the maximum quantity per inner packaging or article for carrying
dangerous goods as limited quantities in accordance with Chapter 3.4.

Column (7b) "Excepted Quantities"

Contains an alphanumeric code with the following meaning:
- "E0" signifies that no exemption from the provisions of ADR exists for the
dangerous goods packed in excepted quantities;

1 x = the class number of the dangerous substance or article, without dividing point if applicable.

- All the other alphanumerical codes starting with the letter "E" signify that
the provisions of ADR are not applicable if the conditions indicated in
Chapter 3.5 are fulfilled.

Column (8) "Packing instructions"

Contains the alphanumeric codes of the applicable packing instructions:
- Alphanumeric codes starting with the letter "P", which refers to packing
instructions for packagings and receptacles (except IBCs and large
packagings), or "R", which refers to packing instructions for light gauge
metal packagings. These are listed in 4.1.4.1 in numerical order, and specify
the packagings and receptacles that are authorized. They also indicate which
of the general packing provisions of 4.1.1, 4.1.2 and 4.1.3, and which of the
special packing provisions of 4.1.5, 4.1.6, 4.1.7, 4.1.8 and 4.1.9 have to be
met. If Column (8) does not contain a code starting with the letters "P" or
"R", the dangerous goods concerned may not be carried in packagings;
- Alphanumeric codes starting with the letters "IBC" refer to packing
instructions for IBCs. These are listed in 4.1.4.2 in numerical order, and
specify the IBCs that are authorized. They also indicate which of the general
packing provisions of 4.1.1, 4.1.2 and 4.1.3, and which of the special
packing provisions of 4.1.5, 4.1.6, 4.1.7, 4.1.8 and 4.1.9 have to be met. If
Column (8) does not contain a code starting with the letters "IBC", the
dangerous goods concerned may not be carried in IBCs;
- Alphanumeric codes starting with the letters "LP" refer to packing
instructions for large packagings. These are listed in 4.1.4.3 in numerical
order, and specify the large packagings that are authorized. They also
indicate which of the general packing provisions of 4.1.1, 4.1.2 and 4.1.3,
and which of the special packing provisions of 4.1.5, 4.1.6, 4.1.7, 4.1.8 and
4.1.9 have to be met. If Column (8) does not contain a code starting with the
letters "LP", the dangerous goods concerned cannot be carried in large
packagings;
NOTE: Special packing provisions, indicated in Column (9a), may change the
above packing instructions.

Column (9a) "Special packing provisions"

Contains the alphanumeric codes of the applicable special packing provisions:
- Alphanumeric codes starting with the letters "PP" or "RR" refer to special
packing provisions for packagings and receptacles (except IBCs and large
packagings) that have additionally to be met. These are to be found in
4.1.4.1, at the end of the relevant packing instruction (with the letter "P" or "
R") referred to in Column (8). If Column (9a) does not contain a code
starting with the letters "PP" or "RR", none of the special packing provisions
listed at the end of the relevant packing instruction apply;
- Alphanumeric codes starting with the letter "B" or the letters "BB" refer to
special packing provisions for IBCs that have additionally to be met. These
are to be found in 4.1.4.2, at the end of the relevant packing instruction (with
the letters "IBC") referred to in Column (8). If Column (9a) does not contain
a code starting with the letter "B" or the letters "BB", none of the special
packing provisions listed at the end of the relevant packing instruction apply;
- Alphanumeric codes starting with the letter "L" refer to special packing
provisions for large packagings that have additionally to be met. These are to
be found in 4.1.4.3, at the end of the relevant packing instruction (with the
letters "LP") referred to in Column (8). If Column (9a) does not contain a
code starting with the letter "L", none of the special packing provisions listed
at the end of the relevant packing instruction apply.

Column (9b) "Mixed packing provisions"

Contains the alphanumeric codes starting with the letters "MP" of the applicable
mixed packing provisions. These are listed in 4.1.10 in numerical order. If
Column (9b) does not contain a code starting with the letters "MP", only the
general requirements apply (see 4.1.1.5 and 4.1.1.6).

Column (10) "Portable tank and bulk container instructions"

Contains an alphanumeric code assigned to a portable tank instruction, in
accordance with 4.2.5.2.1 to 4.2.5.2.4 and 4.2.5.2.6. This portable tank
instruction corresponds to the least stringent provisions that are acceptable for the
carriage of the substance in portable tanks. The codes identifying the other
portable tank instructions that are also permitted for the carriage of the substance
are to be found in 4.2.5.2.5. If no code is given, carriage in portable tanks is not
permitted unless a competent authority approval is granted as detailed in 6.7.1.3.
The general requirements for the design, construction, equipment, type approval,
testing and marking of portable tanks are to be found in Chapter 6.7. The general
requirements for the use (e.g. filling) are to be found in 4.2.1 to 4.2.4.
The indication of a "(M)" means that the substance may be carried in UN
MEGCs.
NOTE: Special provisions, indicated in Column (11), may change the above
requirements.
May also contain alphanumeric codes starting with the letters "BK" referring to
types of bulk containers described in Chapter 6.11 which may be used for the
carriage of bulk goods in accordance with 7.3.1.1 (a) and 7.3.2.

Column (11) "Portable tank and bulk container special provisions"

Contains the alphanumeric codes of the portable tank special provisions that
have additionally to be met. These codes, starting with the letters "TP" refer to
special provisions for the construction or use of these portable tanks. They are to
be found in 4.2.5.3.
NOTE: If technically relevant, these special provisions are not only applicable
to the portable tanks specified in column (10), but also to the portable tanks that
may be used according to the table in 4.2.5.2.5.

Column (12) "Tank codes for ADR tanks"

Contains an alphanumeric code describing a tank type, in accordance with
4.3.3.1.1 (for gases of Class 2) or 4.3.4.1.1 (for substances of Classes 3 to 9).
This tank type corresponds to the least stringent tank provisions that are
acceptable for the carriage of the relevant substance in ADR tanks. The codes
describing the other permitted tank types are to be found in 4.3.3.1.2 (for gases
of Class 2) or 4.3.4.1.2 (for substances of Classes 3 to 9). If no code is given,
carriage in ADR tanks is not permitted.
If in this column a tank code for solids (S) and for liquids (L) is indicated, this
means that this substance may be offered for carriage in tanks in the solid or the
liquid (molten) state. In general this provision is applicable to substances having
melting points from 20 °C to 180 °C.
If for a solid, only a tank code for liquids (L) is indicated in this column, this
means that this substance is only offered for carriage in tanks in the liquid
(molten) state.
The general requirements for the construction, equipment, type approval, testing
and marking that are not indicated in the tank code are to be found in 6.8.1,
6.8.2, 6.8.3 and 6.8.5. The general requirements for the use (e.g. maximum
degree of filling, minimum test pressure) are to be found in 4.3.1 to 4.3.4.

The indication of a "(M)" after the tank code means that the substance can also
be carried in battery-vehicles or MEGCs.
The indication of a (+) after the tank code means that the alternative use of the
tanks is permitted only where this is specified in the certificate of type approval.
For fibre-reinforced plastic tanks, see 4.4.1 and Chapter 6.9; for vacuum
operated waste tanks, see 4.5.1 and Chapter 6.10.
NOTE: Special provisions, indicated in Column (13), may change the above
requirements.

Column (13) "Special provisions for ADR tanks"

Contains the alphanumeric codes of the special provisions for ADR tanks that
have additionally to be met:
- Alphanumeric codes starting with the letters "TU" refer to special
provisions for the use of these tanks. These are to be found in 4.3.5;
- Alphanumeric codes starting with the letters "TC" refer to special provisions
for the construction of these tanks. These are to be found in 6.8.4 (a);
- Alphanumeric codes starting with the letters "TE" refer to special provisions
concerning the items of equipment of these tanks. These are to be found in
6.8.4 (b);
- Alphanumeric codes starting with the letters "TA" refer to special
provisions for the type approval of these tanks. These are to be found in
6.8.4 (c);
- Alphanumeric codes starting with the letters "TT" refer to special provisions
for the testing of these tanks. These are to be found in 6.8.4 (d);
- Alphanumeric codes starting with the letters "TM" refer to special provisions
for the marking of these tanks. These are to be found in 6.8.4 (e).
NOTE: If technically relevant, these special provisions are not only applicable
to the tanks specified in column (12), but also to the tanks that may be used
according to the hierarchies in 4.3.3.1.2 and 4.3.4.1.2.

Column (14) "Vehicle for tank carriage"

Contains a code designating the vehicle (including the drawing vehicle of trailers
or semi-trailers) (see 9.1.1) to be used for the carriage of the substance in tank in
accordance with 7.4.2. The requirements concerning the construction and
approval of vehicles are to be found in Chapters 9.1, 9.2 and 9.7.

Column (15) "Transport category / (Tunnel restriction code)"

Contains at the top of the cell a figure indicating the transport category to which
the substance or article is assigned for the purposes of exemption related to
quantities carried per transport unit (see 1.1.3.6).
Contains at the bottom of the cell, between brackets, the tunnel restriction code
that refers to the applicable restriction for the passage of vehicles carrying the
substance or article through road tunnels. These are to be found in Chapter 8.6.
When no tunnel restriction code has been assigned, this is indicated by the
mention ‘(─)’.

Column (16) "Special provisions for carriage - Packages"

Contains the alphanumeric code(s), starting with letter "V", of the applicable
special provisions (if any) for carriage in packages. These are listed in 7.2.4.

General provisions concerning the carriage in packages are to be found in
Chapters 7.1 and 7.2.
NOTE: In addition, special provisions indicated in Column (18), concerning
loading, unloading and handling, shall be observed.

Column (17) "Special provisions for carriage - Bulk"

Contains the alphanumeric code(s), starting with letters "VC", as well as the
alphanumeric code(s) starting with letters "AP", of the applicable provisions for
carriage in bulk. These are listed in 7.3.3. If no special provision, identified by
the code "VC" or a reference to a specific paragraph, explicitly authorizing this
mode of carriage is indicated in this column, and no special provision, identified
by the code "BK" or a reference to a specific paragraph, explicitly authorizing
this mode of carriage is indicated in column (10), carriage in bulk is not
permitted. General and additional provisions concerning carriage in bulk are to
be found in Chapters 7.1 and 7.3.
NOTE: In addition, special provisions indicated in Column (18), concerning
loading, unloading and handling, shall be observed.

Column (18) "Special provisions for carriage – Loading, unloading and handling"

Contains the alphanumeric code(s), starting with letters "CV", of the applicable
special provisions for loading, unloading and handling. These are listed in
7.5.11. If no code is given, only the general provisions apply (see 7.5.1 to
7.5.10).

Column (19) "Special provisions for carriage - Operation"

Contains the alphanumeric code(s), starting with letter "S", of the applicable
special provisions for operation which are listed in Chapter 8.5. These provisions
shall be applied in addition to the requirements of Chapters 8.1 to 8.4 but in the
event of conflict with the requirements of Chapters 8.1 to 8.4, the special
provisions shall take precedence.

Column (20) "Hazard identification number"

Contains a two or three figure number (preceded in certain cases by the letter
"X") for substances and articles of classes 2 to 9, and for substances and articles
of Class 1, the classification code (see column (3b)). In the cases described in
5.3.2.1, this number shall appear in the upper half of the orange-coloured plates.
The meaning of the hazard identification numbers is explained in 5.3.2.3.

Adres conversie

Adressen splitsen en controleren.

We hebben een handige tool ontwikkeld waarmee je adressen kunt splitsen of je Excel data kunt converteren voor allerlei doeleinden. Probeer het gratis uit!

Data conversie Excel