Download the PHP package codebyray/carlistapi-laravel-sdk without Composer
On this page you can find all versions of the php package codebyray/carlistapi-laravel-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download codebyray/carlistapi-laravel-sdk
More information about codebyray/carlistapi-laravel-sdk
Files in codebyray/carlistapi-laravel-sdk
Package carlistapi-laravel-sdk
Short Description Laravel SDK for the Car List API automotive, powersports, and VIN decoder endpoints.
License MIT
Homepage https://github.com/Codebyray/carlistapi-laravel-sdk
Informations about the package carlistapi-laravel-sdk
Car List API Laravel SDK
A Laravel SDK for interacting with the authenticated Car List API from Laravel 11, 12, and 13 applications.
Laravel 11 compatibility is provided for existing applications. Laravel 11 reached end of security support on March 12, 2026, so Laravel 12 or newer is recommended for actively maintained applications.
This package contains only the API client. It does not include the Car List API server, database, authentication system, billing, admin interface, or import tools.
Requirements
- PHP 8.2+ for Laravel 11 and 12
- PHP 8.3+ for Laravel 13
- Laravel 11, 12, or 13
- A Car List API bearer token
Laravel 11 compatibility is maintained for existing applications, but Laravel 11 itself is end-of-life and no longer receives framework security updates. Laravel 12 or newer is recommended.
Installation
Install via Composer:
Laravel package auto-discovery registers the service provider and facade automatically.
Publishing the config
Publishing is optional. Use it only when you want to customize package configuration in the consuming application:
After changing .env or published configuration, clear Laravel's configuration cache:
Configuration
Add the required connection settings to the consuming application's .env file:
The base URL must end at /api. Do not include the API version in CAR_LIST_API_URL; the SDK appends CAR_LIST_API_VERSION to every request.
For local development:
This produces URLs such as:
When a new API version is available, update only:
Optional HTTP settings
The following environment variables are optional. The SDK provides sensible defaults:
User Agent
By default, requests include a User-Agent identifying the SDK and its version, for example:
You can override it by setting:
Quick Start
Usage
Dependency injection
Facade
VIN decoder
The SDK normalizes spaces, hyphens, and letter casing before sending the VIN.
Powersports
Per-request token override
Responses
All successful requests return an ApiResponse instance:
Exceptions
The SDK throws typed exceptions for common HTTP and transport errors.
| Exception | Description |
|---|---|
AuthenticationException |
HTTP 401 Unauthorized |
AuthorizationException |
HTTP 403 Forbidden |
NotFoundException |
HTTP 404 Not Found |
ValidationException |
HTTP 422 Unprocessable Entity |
RateLimitException |
HTTP 429 Too Many Requests. Includes limit, used, remaining, and resetAt properties. |
ServerException |
HTTP 5xx Server Error |
TransportException |
Network or transport failure (timeouts, DNS errors, connection failures, etc.). |
Endpoint coverage
The SDK wraps all authenticated routes currently defined by the Car List API:
- Automotive years, makes, models, trims, engines, vehicle IDs, full details, logos, body styles, fuel types, drive types, and door counts
- Powersports years, makes, models, sub-models, vehicle IDs, full details, logos, and type-filtered routes
- VIN decoding with optional model year
Demo endpoints are intentionally excluded because this package is intended for authenticated production API access.
Testing
The GitHub Actions matrix tests Laravel 11, Laravel 12, and Laravel 13.
Support
- Documentation: https://carlistapi.com/docs
- Issues: https://github.com/Codebyray/carlistapi-laravel-sdk/issues
License
MIT
All versions of carlistapi-laravel-sdk with dependencies
illuminate/contracts Version ^11.0 || ^12.0 || ^13.0
illuminate/http Version ^11.0 || ^12.0 || ^13.0
illuminate/support Version ^11.0 || ^12.0 || ^13.0