Merr një klient sipas id (v1): fature.al API

GET /api/v1/clients/{id}/details Requires authentication Rate limited by the `api-global` limiter v1

Send a bearer token, plus the X-Client-Id and X-Client-Secret headers in the Authorization header.

Kthen një klient të vetëm me të gjitha fushat, kompani ose person.

Përdoreni kur keni ruajtur id-në nga lista ose nga krijimi dhe ju duhen të dhënat e përditësuara. company_type kthehet null për një person, first_name dhe surname për një kompani; name mban gjithmonë emrin e plotë.

URL-ja e plotë: https://fature.al/api/v1/clients/{id}/details

Path parameters

Name	Tipi	E detyrueshme	Përshkrimi
id	integer	yes	Id-ja e klientit në fature.al.

Përgjigjet

200 Klienti i kërkuar te `client`, me të gjitha fushat.

Field	Tipi	Përshkrimi
status	boolean
data	object
data.client	object
data.client.id	integer	Id-ja e klientit në fature.al
data.client.name	string	Emri i plotë: emri i kompanisë te një kompani, emri dhe mbiemri te një person
data.client.client_type	string, nullable	`COMPANY` ose `PERSON`
data.client.company_name	string, nullable	Emri i kompanisë; bosh ose null te një person
data.client.company_type	string, nullable	Kategoria e kompanisë: `BUSINESS`, `BANK` ose `EXCHANGE`. Gjithmonë null te një person
data.client.nipt	string, nullable	NIPT-i i kompanisë, ose numri VAT/TAX i një biznesi të huaj; null kur nuk ka
data.client.first_name	string, nullable	Emri i personit; gjithmonë null te një kompani
data.client.surname	string, nullable	Mbiemri i personit; gjithmonë null te një kompani
data.client.birthday	string, nullable	Data e lindjes, `YYYY-MM-DD`; null kur nuk është dhënë
data.client.id_type	string, nullable	Lloji i dokumentit të identifikimit: `NUIS`, `ID`, `PASS`, `VAT`, `TAX` ose `SOC`; null kur nuk është regjistruar
data.client.id_num	string, nullable	Numri i dokumentit: NIPT-i te një kompani, numri i dokumentit personal te një person
data.client.nationality_code	string, nullable	Shteti i klientit, kod ISO 3166-1 alpha-3
data.client.nationality_id	integer, nullable	Id-ja e shtetit në fature.al, çifti i `nationality_code`
data.client.telephone	string, nullable	Telefoni
data.client.email	string, nullable	Email-i
data.client.address	string, nullable	Adresa
data.client.city	string, nullable	Qyteti
data.client.customer_number	string, nullable	Numri i klientit në sistemin tuaj. Kur nuk e keni dhënë, fature.al vë numrin rendor të klientit brenda kompanisë
data.client.created_at	string, nullable	Data dhe ora e krijimit, ISO 8601

401 Unauthenticated

Field	Tipi	Përshkrimi
message	string

404 Klienti nuk u gjet, ose nuk i përket kompanisë suaj.

Field	Tipi	Përshkrimi
status	boolean	Gjithmonë false. Një përgjigje e suksesshme mban `status: true` dhe objektin `data`
message	string	Përshkrimi i gabimit. Bosh kur dështimi nuk mban ndonjë mesazh të vetin
errors	array	Mesazhe për t'u shfaqur te përdoruesi ose për t'u ruajtur në log. Mungon kur nuk ka gjë për të shtuar përtej `message`

500 Gabim i papritur në server.

Field	Tipi	Përshkrimi
status	boolean	Gjithmonë false. Një përgjigje e suksesshme mban `status: true` dhe objektin `data`
message	string	Përshkrimi i gabimit. Bosh kur dështimi nuk mban ndonjë mesazh të vetin
errors	array	Mesazhe për t'u shfaqur te përdoruesi ose për t'u ruajtur në log. Mungon kur nuk ka gjë për të shtuar përtej `message`

Shembull kërkese

cURL

curl -X GET 'https://fature.al/api/v1/clients/42/details' \
  -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/clients/42/details');

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/v1/clients/42/details', [
    '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/clients/42/details', {
  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();

Shembull përgjigjeje

200

{
    "status": true,
    "data": {
        "client": {
            "id": 42,
            "name": "Alpha SHPK",
            "client_type": "COMPANY",
            "company_name": "Alpha SHPK",
            "company_type": "BUSINESS",
            "nipt": "L91806031A",
            "first_name": "Agon",
            "surname": "Hoxha",
            "birthday": "1990-01-15",
            "id_type": "NUIS",
            "id_num": "L91806031A",
            "nationality_code": "ALB",
            "nationality_id": 3,
            "telephone": "+355691234567",
            "email": "[email protected]",
            "address": "Rruga e Kavajës 12",
            "city": "Tiranë",
            "customer_number": "CLI-001",
            "created_at": "2026-09-13T10:15:00+02:00"
        }
    }
}

401

{
    "message": "Unauthenticated."
}

404

{
    "status": false,
    "message": "Te dhenat jo te sakta.",
    "errors": [
        "errors"
    ]
}

500

{
    "status": false,
    "message": "Te dhenat jo te sakta.",
    "errors": [
        "errors"
    ]
}