Installation

Requirements

PHP	^8.2
Laravel	11.x, 12.x or 13.x

Install via Composer

composer require bhry98/laravel-api-response

The service provider and the ApiResponse facade alias are auto-discovered - nothing else is required. Every feature documented here works out of the box with sensible defaults; rate limiting, audit logging and locale resolution are all opt-in.

Publishing

Config

php artisan vendor:publish --tag=bhry98-api-response-config

Creates config/bhry98-api-response.php with commented sections for keys, wrapping, messages, templates, meta, versioning, debug mode, exception handling, the response-factory override, rate limiting, audit logging and locale resolution. Every feature in these docs maps to a section in that file.

Translations

php artisan vendor:publish --tag=bhry98-api-response-lang

Publishes lang/vendor/bhry98-api-response - see Localization.

Audit log migration

Only needed if you turn on audit logging:

php artisan vendor:publish --tag=bhry98-api-response-migrations
php artisan migrate

This publishes a timestamped migration that creates the api_response_audit_logs table (the table name itself is configurable via audit_log.table).

Next

Head to Responses to start sending your first api() response, or to Customization to wire up rate limiting, audit logging or locale resolution.