LARC (1.0.0)

Download OpenAPI specification:Download

Getting the list of authorized racket coverings (LARC).

This API provides means to acquire the list of authorized racket coverings (LARC) of the ITTF.

It is not an official project of the ITTF but a private one.

The API provides read-only access only, there are no means to change the LARCs.

At the moment, the API relies directly on json files, it is not supported by a real REST server. This means, additional header information etc. is not provided. Dynamic content generation (search etc.) is not possible as well. This may change in the future.

LARC

Specific LARC content.

Get list of all LARCs.

Retrieve information of all available larcs.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "associations": {
    },
  • "larcs": {
    },
  • "meta": {}
}

Get LARC by ID

Retrieve the information of the brand with the matching brand ID.

path Parameters
larcId
required
string^\d{4}-\d{1}|current$
Example: 2022-1

LARC id is a combination of year and the number of the LARC in that year, e.g. 2021-3. Special value "current" for the current LARC is allowed.

Responses

Response samples

Content type
application/json
{
  • "meta": {},
  • "_links": [
    ],
  • "id": "2022-1",
  • "name": "LARC 2022-1",
  • "coverings": {
    },
  • "brands": {
    },
  • "valid_for": [
    ],
  • "valid_from": "2022-01-01",
  • "valid_to": "2022-03-31",
  • "colors": {
    },
  • "pimpletypes": {
    }
}

List

Content lists.

Get list of all LARCs.

Retrieve information of all available larcs.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "associations": {
    },
  • "larcs": {
    },
  • "meta": {}
}

Get list of all associations.

Retrieve information of all available associations.

Responses

Response samples

Content type
application/json
{
  • "associations": {
    },
  • "meta": {}
}

Get list of all brands.

Retrieve information of all available brands.

Responses

Response samples

Content type
application/json
{
  • "brands": {
    },
  • "meta": {}
}

Association

Specific association content.

Get list of all associations.

Retrieve information of all available associations.

Responses

Response samples

Content type
application/json
{
  • "associations": {
    },
  • "meta": {}
}

Get association by ID

Retrieve the information of the association with the matching association ID.

path Parameters
associationId
required
string
Example: ittf

Association id is a freely defineable text.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "id": "dttb",
  • "larcs": [
    ],
  • "meta": {},
  • "name": "DTTB",
  • "seasonstart_month": 7,
  • "valid_from": "2021-07-01",
  • "valid_to": "2022-06-30",
  • "validity": "season"
}

Brand

Specific brand content.

Get list of all brands.

Retrieve information of all available brands.

Responses

Response samples

Content type
application/json
{
  • "brands": {
    },
  • "meta": {}
}

Get brand by ID

Retrieve the information of the brand with the matching brand ID.

path Parameters
brandId
required
string^\d{1,3}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-...
Example: 203

Unique brand id. ID can be the code. If no code is assigned by the ITTF, a generated UUID is used.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "code": "177",
  • "colors": {
    },
  • "coverings": {
    },
  • "id": "177",
  • "meta": {},
  • "name": "Arbalest",
  • "pimpletypes": {
    }
}

Meta

Information about the API root, last update, and current LARC.

Get meta information about data and API.

Get meta information of the API, especially API version and last update of the LARC data. This should provide the smallest amount of data to check if the data was updated.

Responses

Response samples

Content type
application/json
{
  • "_links": [
    ],
  • "meta": {}
}