Parking Permits Validation

Permission management provides various APIs to check active parking permits and retrieve permit information.

These endpoints support different data formats and use cases, from simple registration checks to detailed permit information.

GET /api/v1/tickets/zone/{zone}

Get active permits by zone (Simple JSON)

Retrieves an array of active vehicle registration numbers for a specific zone.

This endpoint provides a simple list of registration numbers without additional permit details.

Headers

  • Name
    Authorization
    Type
    Bearer
    Description

    Apply your authentication token here.

  • Name
    Accept
    Type
    application/json
    Description

    Tell the server that you want to receive JSON responses.

URL Parameters

  • Name
    zone
    Type
    integer
    Required
    Description

    The zone number to check for active permits.

Request Example 

curl -X GET 'https://gavle.parkeraisverige.com/api/v1/tickets/zone/1234' \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \

2xx Successful response 

{
  "data": [
    "ABC123",
    "DEF456"
  ]
}

401 Unauthorized

Your token is not provided

403 Forbidden

Your token is provided but incorrect
GET /api/v1/attendants/check-tickets

Check permits with extended information

Retrieve detailed permit information for a given zone or registration number.

This endpoint returns comprehensive permit details including validity periods and notes.

Headers

  • Name
    Authorization
    Type
    Bearer
    Description

    Apply your authentication token here.

  • Name
    Accept
    Type
    application/json
    Description

    Tell the server that you want to receive JSON responses.

Parameters

  • Name
    registration_number
    Type
    string
    Description

    Registration number to check for active permits. Either this or zone is required.

  • Name
    zone
    Type
    integer
    Description

    Zone number to check for active permits. Either this or registration_number is required.

Request Example 

curl -X GET 'https://gavle.parkeraisverige.com/api/v1/attendants/check-tickets' \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "zone": 1234
}'

2xx Successful response 

[
  {
    "registration_number": "BFQ697",
    "zone": 9268,
    "active": true,
    "start_at": "2025-03-13T18:21:52.612342Z",
    "end_at": "2025-03-14T01:24:52.612342Z",
    "note": "OxF4ozC39HGJp7pC"
  }
]

401 Unauthorized

Your token is not provided

403 Forbidden

Your token is provided but incorrect
GET /api/v1/paris/searchByRegNo

Search permits by registration (Paris specs)

Retrieve active parking permits for a given registration number using Paris specification format.

This endpoint returns XML-formatted data including transaction details and parking zone information.

Query Parameters

  • Name
    aPassword
    Type
    string
    Required
    Description

    Authentication password for the API.

  • Name
    aRegNo
    Type
    string
    Required
    Description

    The registration number to check for active permits.

Request Example 

curl -X GET 'https://gavle.parkeraisverige.com/api/v1/paris/searchByRegNo?aPassword=password&aRegNo=ABC123' \

2xx Successful response (XML format) 

<?xml version="1.0" encoding="UTF-8"?>
<Contractor>
    <Result>
        <TransactionId>123456789</TransactionId>
        <Parkings>
            <RegNo>ABC123</RegNo>
            <Parking>
                <IsFareType>1</IsFareType>
                <FareType>Normal taxa</FareType>
                <Note>Zon 3122 (Example parking lot), Starttid: 2022-01-01 11:00:00</Note>
            </Parking>
            <Parking>
                <IsFareType>1</IsFareType>
                <FareType>Normal taxa</FareType>
                <Note>Zon 3123 (Another example parking lot), Starttid: 2022-01-01 12:00:00</Note>
            </Parking>
        </Parking>
    </Parkings>
</Result>
</Contractor>

401 Unauthorized

Invalid password provided