v1.0 API Reference

Developer API Reference

Automate and build analytical tracking software utilizing telemetry profile snapshots, localized vehicle catalog trees, and real-time division standings.

Authentication & Limit Headers

Every inbound request to metered endpoints requires validation via personal security strings passed cleanly as state within headers.

Authorization: Bearer YOUR_TOKEN_SECRET
Accept: application/json

Metered operations dynamically calculate consumption profiles relative to custom user policies, instantly attaching structural accounting properties back onto responses.

Injected Consumption Headers
X-Quota-Limit 1000
X-Quota-Remaining 942
HTTP 429 Message Quota Exceeded
GET /api/assets/manufacturers
Metered (10 requests/min)

Returns a full index of automotive manufacturers mapping internal database reference IDs to primary asset properties.

JSON Blueprint Response Schema HTTP 200 OK 
[
        {
            "id": 144,
            "name": "Suzuki",
            "logo": "https://gtgridstats.com/storage/logos/suzuki.png"
        },
        {
            "id": 78,
            "name": "Ferrari",
            "logo": "https://gtgridstats.com/storage/logos/ferrari.png"
        }
    ]
GET /api/assets/manufacturers/{code}
Metered (10 requests/min)

Fetches the complete manufacturing index with names localized to the requested region language code without modifying application state.

Request Arguments
code string required
Strict 2-letter country locale code matching verified table entries (e.g., 'cn', 'jp', 'gb', 'us').
JSON Blueprint Response Schema HTTP 200 OK 
[
        {
            "id": 78,
            "name": "法拉利",
            "logo": "https://gtgridstats.com/storage/logos/ferrari.png"
        }
    ]
GET /api/assets/cars
Metered (10 requests/min)

Paginates through the global car catalog dataset, flattening translation records down directly to default system languages.

Request Arguments
page integer
Target page subset for the collection pagination map. Defaults to 1.
JSON Blueprint Response Schema HTTP 200 OK 
{
        "current_page": 1,
        "data": [
            {
                "id": 613,
                "car_code": 1544,
                "gt7_code": "car1544",
                "name": "Ferrari 430 Scuderia '07",
                "class": "Gr.N",
                "image": "https://www.gran-turismo.com/common/dist/gt7/carlist/car_images/car1544.webp",
                "manufacturer": {
                    "id": 78,
                    "name": "Ferrari"
                }
            }
        ],
        "next_page_url": "https://gtgridstats.com/api/assets/cars?page=2",
        "total": 482
    }
GET /api/assets/cars/{identifier}/{locale?}
Metered (10 requests/min)

Safely resolves a specific car by matching its internal id, car_code, or gt7_car_code format strings without data leakage risk.

Request Arguments
identifier mixed required
The target tracking identity code (e.g., 1544, 613, car1544).
locale string
Optional 2-letter country string parameter to fetch localized vehicle name data (e.g. 'cn', 'jp', 'de').
JSON Blueprint Response Schema HTTP 200 OK 
{
        "id": 613,
        "car_code": 1544,
        "gt7_code": "car1544",
        "name": "法拉利 430 Scuderia '07",
        "class": "Gr.N",
        "image": "https://www.gran-turismo.com/common/dist/gt7/carlist/car_images/car1544.webp",
        "manufacturer": {
            "id": 78,
            "name": "法拉利"
        }
    }
GET /api/assets/manufacturer/{manufacturer_id}/cars/{locale?}
Metered (10 requests/min)

Retrieves all catalog vehicles registered under the specific internal database manufacturer ID, isolated from single vehicle ID collisions.

Request Arguments
manufacturer_id integer required
Internal auto-increment primary key ID of the manufacturer (e.g. 78, 144).
locale string
Optional trailing country reference (e.g. 'cn') to output arrays matching explicit language rows.
JSON Blueprint Response Schema HTTP 200 OK 
{
        "manufacturer": "Ferrari",
        "count": 14,
        "cars": [
            {
                "id": 613,
                "car_code": 1544,
                "gt7_code": "car1544",
                "name": "Ferrari 430 Scuderia '07",
                "class": "Gr.N",
                "image": "https://www.gran-turismo.com/common/dist/gt7/carlist/car_images/car1544.webp",
                "manufacturer": {
                    "id": 78,
                    "name": "Ferrari"
                }
            }
        ]
    }
GET /api/assets/manufacturer/{manufacturer_id}/{car_class}/{locale?}
Metered (10 requests/min)

Filters a manufacturer’s fleet down to a specific category group. Automatically parses dots out of incoming strings safely.

Request Arguments
manufacturer_id integer required
Target database manufacturer primary index key.
car_class string required
Classification tag configuration (e.g. gr3, gr.3, grn, gr.b, gr1, gr4).
locale string
Optional 2-letter country code matching active database localization metrics.
JSON Blueprint Response Schema HTTP 200 OK 
{
        "manufacturer": "Ferrari",
        "class": "Gr.3",
        "count": 2,
        "cars": [
            {
                "id": 620,
                "car_code": 1610,
                "gt7_code": "car1610",
                "name": "Ferrari 458 Italia GT3 '13",
                "class": "Gr.3",
                "image": "https://www.gran-turismo.com/common/dist/gt7/carlist/car_images/car1610.webp",
                "manufacturer": {
                    "id": 78,
                    "name": "Ferrari"
                }
            }
        ]
    }
GET /api/assets/regions
⚡ QUOTA FREE (30 requests/min limit)

Fetches the complete registry loop of active world configurations. This endpoint does not consume daily tracking caps.

JSON Blueprint Response Schema HTTP 200 OK 
[
        {
            "id": 5,
            "code": "cn",
            "name": "China",
            "is_active": true
        },
        {
            "id": 10,
            "code": "gb",
            "name": "United Kingdom",
            "is_active": true
        },
        {
            "id": 30,
            "code": "us",
            "name": "United States",
            "is_active": true
        }
    ]
POST /api/racers
Metered (10 requests/min)

Processes batch profiling tracking queries passed within payload structures to safely sync remote driver records. To protect infrastructure limits, requests for stale or unindexed drivers are safely staggered by 3 seconds per driver. The request will remain open until all data is gathered (up to ~48 seconds for a full batch of 16 new drivers).

Request Arguments
identifiers array | string required
Array or comma-separated list parameters mapping targeted drivers. Maximum length limit: 16 values.
JSON Blueprint Response Schema HTTP 200 OK 
{
    "status": "complete",
    "count": 3,
    "not_found": [],
    "drivers": [
        {
            "PSN_ID": "skino2024",
            "Nickname": "Skino",
            "GUID": "54284943-ff00-4801-9086-c34c969a1ad0",
            "DR": "B",
            "SR": "S",
            "last_sync": "2026-05-20 13:59:01",
            "country_code": "GB",
            "stats": {
                "dr_points": 11027,
                "dr_ratio": 0.05135,
                "total_races": 223,
                "victories": 10,
                "poles": 3,
                "fastest_laps": 5,
                "clean_races": 49,
                "collector_level": 70,
                "license": "Master",
                "garage_count": 629,
                "collection_progress": "100%",
                "total_credits": 686491958,
                "play_time_readable": "1,265h 4m",
                "distance_km": "100,520.7"
            }
        },
        {
            "PSN_ID": "SparksTheory",
            "Nickname": "Sparks",
            "GUID": "85596fe8-f2f8-45c1-9474-f3357e8d9446",
            "DR": "A+",
            "SR": "S",
            "last_sync": "2026-05-20 13:59:05",
            "country_code": "GB",
            "stats": {
                "dr_points": 56101,
                "dr_ratio": 0.06101,
                "total_races": 2490,
                "victories": 361,
                "poles": 457,
                "fastest_laps": 317,
                "clean_races": 815,
                "collector_level": 70,
                "license": "N/A",
                "garage_count": 243,
                "collection_progress": "58%",
                "total_credits": 315834767,
                "play_time_readable": "2,244h 51m",
                "distance_km": "260,752.2"
            }
        },
        {
            "PSN_ID": "OFFICIAL_001",
            "Nickname": "AHR_REDACTED",
            "GUID": "b51f1834-d03d-4ebd-8342-d87ba61ebb9a",
            "DR": "A+",
            "SR": "S",
            "last_sync": "2026-05-20 13:59:09",
            "country_code": "GB",
            "stats": {
                "dr_points": 63506,
                "dr_ratio": 0.13506,
                "total_races": 339,
                "victories": 65,
                "poles": 74,
                "fastest_laps": 69,
                "clean_races": 152,
                "collector_level": 70,
                "license": "N/A",
                "garage_count": 608,
                "collection_progress": "85%",
                "total_credits": 739251528,
                "play_time_readable": "2,670h 53m",
                "distance_km": "132,281.8"
            }
        }
    ]
}
GET /api/racers/{identifiers}
Metered (10 requests/min)

Retrieves deep analytics profiling performance metrics parsed via inline list strings. Strictly limited to 16 driver handles max. Unindexed or missing PSNs are safely skipped and returned in a dedicated `not_found` array.

Request Arguments
identifiers string required
Comma-separated lookup tokens (e.g., skino2024,Sparkstheory,OFFICIAL_001). Enforces an absolute execution ceiling of 16 distinct users.
JSON Blueprint Response Schema HTTP 200 OK 
{
    "status": "complete",
    "count": 3,
    "not_found": [],
    "drivers": [
        {
            "PSN_ID": "skino2024",
            "Nickname": "Skino",
            "GUID": "54284943-ff00-4801-9086-c34c969a1ad0",
            "DR": "B",
            "SR": "S",
            "last_sync": "2026-05-20 13:59:01",
            "country_code": "GB",
            "stats": {
                "dr_points": 11027,
                "dr_ratio": 0.05135,
                "total_races": 223,
                "victories": 10,
                "poles": 3,
                "fastest_laps": 5,
                "clean_races": 49,
                "collector_level": 70,
                "license": "Master",
                "garage_count": 629,
                "collection_progress": "100%",
                "total_credits": 686491958,
                "play_time_readable": "1,265h 4m",
                "distance_km": "100,520.7"
            }
        },
        {
            "PSN_ID": "SparksTheory",
            "Nickname": "Sparks",
            "GUID": "85596fe8-f2f8-45c1-9474-f3357e8d9446",
            "DR": "A+",
            "SR": "S",
            "last_sync": "2026-05-20 13:59:05",
            "country_code": "GB",
            "stats": {
                "dr_points": 56101,
                "dr_ratio": 0.06101,
                "total_races": 2490,
                "victories": 361,
                "poles": 457,
                "fastest_laps": 317,
                "clean_races": 815,
                "collector_level": 70,
                "license": "N/A",
                "garage_count": 243,
                "collection_progress": "58%",
                "total_credits": 315834767,
                "play_time_readable": "2,244h 51m",
                "distance_km": "260,752.2"
            }
        },
        {
            "PSN_ID": "OFFICIAL_001",
            "Nickname": "AHR_REDACTED",
            "GUID": "b51f1834-d03d-4ebd-8342-d87ba61ebb9a",
            "DR": "A+",
            "SR": "S",
            "last_sync": "2026-05-20 13:59:09",
            "country_code": "GB",
            "stats": {
                "dr_points": 63506,
                "dr_ratio": 0.13506,
                "total_races": 339,
                "victories": 65,
                "poles": 74,
                "fastest_laps": 69,
                "clean_races": 152,
                "collector_level": 70,
                "license": "N/A",
                "garage_count": 608,
                "collection_progress": "85%",
                "total_credits": 739251528,
                "play_time_readable": "2,670h 53m",
                "distance_km": "132,281.8"
            }
        }
    ]
}
GET /api/series-{series}/drivers/{psn_list}
Metered (10 requests/min)

Pulls an historical round performance tracker parsing results matching an inline batch pattern of requested PSN IDs.

Request Arguments
series string required
The targeting official championship identifier key (e.g. gt7_championship_id).
psn_list string required
Comma-separated loop strings containing valid target driver tags.
JSON Blueprint Response Schema HTTP 200 OK 
{
        "series_id": "1564",
        "type": "Nations Cup",
        "driver_count": 1,
        "drivers": [
            {
                "psn": "skino2024",
                "season_rank": 14,
                "total_points": 342,
                "rounds": [
                    {
                        "no": 1,
                        "points": 120,
                        "is_counted": true
                    }
                ]
            }
        ]
    }