Lista e llogarive bankare (v1)

GET /api/v1/bank-accounts Requires authentication Rate limited by the `api-global` limiter v1

Send a bearer token in the Authorization header.

Merr listen e llogarive bankare aktive te kompanise me faqosje dhe filtrim me tekst.

Full URL: https://fature.al/api/v1/bank-accounts

Query parameters

Name	Type	Required	Description
limit	integer	no	Numri i llogarive per faqe (max 100). Defaults to `20`.
offset	integer	no	Nga cila llogari te fillohet. Defaults to `0`.
query	string	no	Kerkim ne emer te bankes, IBAN, SWIFT, mbajtes ose shenime.

Responses

200 OK

Field	Type	Description
status	boolean
data	object
data.items	array
data.items[].id	integer
data.items[].bank_name	string, nullable
data.items[].iban	string, nullable
data.items[].swift	string, nullable
data.items[].holder	string, nullable
data.items[].currency_code	string, nullable
data.items[].is_default	boolean
data.items[].notes	string, nullable
data.items[].valid_from	string, nullable
data.items[].valid_to	string, nullable
data.items[].created_at	string, nullable
data.pagination	object
data.pagination.records	integer
data.pagination.total	integer
data.pagination.limit	integer
data.pagination.offset	integer

429 Kufiri i kerkesave u arrit. Kufiri per endpoint kthen zarfin standard te gabimit; kufiri i pergjithshem kthen vetem `message` bashke me header-in `Retry-After`.

Field	Type	Description
status	boolean	Always false. A successful response carries `status: true` and a `data` object instead
message	string	The exception message. Empty when the failure carries no exception of its own
errors	array	Messages to show the operator or to log. Absent when the failure has nothing to add beyond `message`

500 Gabim i papritur ne server.

Field	Type	Description
status	boolean	Always false. A successful response carries `status: true` and a `data` object instead
message	string	The exception message. Empty when the failure carries no exception of its own
errors	array	Messages to show the operator or to log. Absent when the failure has nothing to add beyond `message`

Example request

cURL

curl -X GET 'https://fature.al/api/v1/bank-accounts' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Client-Id: YOUR_CLIENT_ID' \
  -H 'X-Client-Secret: YOUR_CLIENT_SECRET' \
  -H 'Accept: application/json'

PHP (Laravel)

use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
    'Authorization' => 'Bearer YOUR_TOKEN',
    'X-Client-Id' => 'YOUR_CLIENT_ID',
    'X-Client-Secret' => 'YOUR_CLIENT_SECRET',
    'Accept' => 'application/json',
])->get('https://fature.al/api/v1/bank-accounts');

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/v1/bank-accounts', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_TOKEN',
        'X-Client-Id' => 'YOUR_CLIENT_ID',
        'X-Client-Secret' => 'YOUR_CLIENT_SECRET',
        'Accept' => 'application/json',
    ],
]);

$data = json_decode((string) $response->getBody(), true);

JavaScript

const response = await fetch('https://fature.al/api/v1/bank-accounts', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'X-Client-Id': 'YOUR_CLIENT_ID',
    'X-Client-Secret': 'YOUR_CLIENT_SECRET',
    'Accept': 'application/json'
  }
});

const data = await response.json();

Example response

200

{
    "status": true,
    "data": {
        "items": [
            {
                "id": 1,
                "bank_name": "Jane Doe",
                "iban": "iban",
                "swift": "swift",
                "holder": "holder",
                "currency_code": "USD",
                "is_default": true,
                "notes": "notes",
                "valid_from": "valid from",
                "valid_to": "valid to",
                "created_at": "created at"
            }
        ],
        "pagination": {
            "records": 1,
            "total": 4200,
            "limit": 25,
            "offset": 0
        }
    }
}

429

{
    "status": true,
    "message": "Hello there",
    "errors": [
        "errors"
    ]
}

500

{
    "status": true,
    "message": "Hello there",
    "errors": [
        "errors"
    ]
}