# Ver un empleado

`GET https://api.fiscalisto.com/v1/employees/{id}`

Un empleado con sus datos y lo que el SAT podría rechazar en warnings.

## Parámetros

| Nombre | Dónde | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `id` | ruta | sí | El id del objeto. |

## Con el SDK de TypeScript

```ts
import { Fiscalisto } from "fiscalisto";

// La llave viene de FISCALISTO_API_KEY.
const fiscalisto = new Fiscalisto();

const employee = await fiscalisto.employees.get("emp_OufpKqnrvx9p3RxmD1RIDgEHzKYPYnYBlV");
```

## Con el SDK de Python

```python
from fiscalisto import Fiscalisto

# La llave viene de FISCALISTO_API_KEY.
fiscalisto = Fiscalisto()

employee = fiscalisto.employees.get("emp_OufpKqnrvx9p3RxmD1RIDgEHzKYPYnYBlV")
```

## Con el SDK de PHP

```php
<?php

use Fiscalisto\Fiscalisto;

// La llave viene de FISCALISTO_API_KEY.
$fiscalisto = new Fiscalisto();

$employee = $fiscalisto->employees->get('emp_OufpKqnrvx9p3RxmD1RIDgEHzKYPYnYBlV');
```

## Con el SDK de .NET

```csharp
using Fiscalisto;

// La llave viene de FISCALISTO_API_KEY.
var fiscalisto = new FiscalistoClient();

var employee = await fiscalisto.Employees.GetAsync("emp_OufpKqnrvx9p3RxmD1RIDgEHzKYPYnYBlV");
```

## Con el SDK de Go

```go
package main

import (
	"context"
	"fmt"
	"log"

	fiscalisto "fiscalisto.com/go"
)

func main() {
	// La llave viene de FISCALISTO_API_KEY.
	client, err := fiscalisto.NewClient("")
	if err != nil {
		log.Fatal(err)
	}
	ctx := context.Background()

	employee, err := client.Employees.Get(ctx, "emp_OufpKqnrvx9p3RxmD1RIDgEHzKYPYnYBlV")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(employee.ID)
}
```

## Con el SDK de Java

```java
import com.fiscalisto.FiscalistoClient;

// La llave viene de FISCALISTO_API_KEY.
var fiscalisto = new FiscalistoClient();

var employee = fiscalisto.employees().get("emp_OufpKqnrvx9p3RxmD1RIDgEHzKYPYnYBlV");
System.out.println(employee.getId());
```

## Respuesta 200

Correcto.

Un objeto `Employee`:

| Campo | Tipo | Siempre viene | Descripción |
| --- | --- | --- | --- |
| `id` | string | sí | Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). |
| `livemode` | boolean | sí | true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. |
| `object` | `"employee"` | sí | Qué tipo de objeto es («invoice», «customer»…). |
| `issuer` | string | sí | El emisor (iss_…). |
| `number` | string | sí | Número de empleado (NumEmpleado). |
| `name` | string | sí | Nombre completo del empleado. |
| `tax_id` | string | sí | RFC (Rfc), 12 caracteres una persona moral y 13 una física. |
| `curp` | string | sí | CURP, 18 caracteres. |
| `social_security_number` | string | sí | Número de seguridad social (NumSeguridadSocial), 11 dígitos. |
| `zip` | string | sí | Código postal del domicilio fiscal, 5 dígitos, como en la constancia de situación fiscal. El de un emisor es el lugar de expedición (LugarExpedicion) de sus comprobantes. |
| `email` | string o null | sí | Correo del empleado, a donde van sus recibos. |
| `start_date` | string | sí | Fecha de inicio de la relación laboral (FechaInicioRelLaboral), AAAA-MM-DD. |
| `end_date` | string o null | sí | Último día trabajado si ya no trabaja ahí, AAAA-MM-DD. |
| `daily_salary` | number | sí | Salario diario. |
| `integrated_daily_salary` | number | sí | Salario diario integrado (SalarioDiarioIntegrado): no menor al salario diario. |
| `contract_type` | string | sí | Tipo de contrato (TipoContrato), c_TipoContrato. Por omisión 01, por tiempo indeterminado. |
| `workday_type` | string | sí | Tipo de jornada (TipoJornada), c_TipoJornada. Por omisión 01, diurna. |
| `regime_type` | string | sí | Tipo de régimen (TipoRegimen): 02 sueldos y salarios. |
| `periodicity` | string | sí | Periodicidad del pago (PeriodicidadPago): 02 semanal, 03 catorcenal, 04 quincenal (por omisión), 05 mensual. |
| `risk_class` | string | sí | Clase de riesgo del puesto ante el IMSS (RiesgoPuesto), 1 a 5. Por omisión 1. |
| `state` | string | sí | Entidad federativa donde trabaja (ClaveEntFed): JAL, CMX, NLE… |
| `border_zone` | boolean | sí | true si trabaja en la zona libre de la frontera norte (salario mínimo de frontera). |
| `unionized` | boolean | sí | true si es sindicalizado (Sindicalizado). |
| `department` | string o null | sí | Departamento (Departamento). |
| `position` | string o null | sí | Puesto (Puesto). |
| `warnings` | arreglo de string | sí | Lo que el SAT podría observar de sus datos, antes de timbrar. |
| `created_at` | string (date-time) | sí | Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00). |

```json
{
  "id": "emp_OufpKqnrvx9p3RxmD1RIDgEHzKYPYnYBlV",
  "object": "employee",
  "livemode": false,
  "issuer": "iss_OufpKqnrvx9p",
  "number": "9",
  "name": "ANA GÓMEZ RUIZ",
  "tax_id": "GORA800101JK2",
  "curp": "GORA800101MDFMZN09",
  "social_security_number": "12345678903",
  "zip": "06000",
  "email": null,
  "start_date": "2024-03-04",
  "end_date": null,
  "daily_salary": 320,
  "integrated_daily_salary": 334.66,
  "contract_type": "01",
  "workday_type": "01",
  "regime_type": "02",
  "periodicity": "02",
  "risk_class": "1",
  "state": "CMX",
  "border_zone": false,
  "unionized": false,
  "department": null,
  "position": null,
  "warnings": [],
  "created_at": "2026-10-20T09:02:11-06:00"
}
```

## Errores

Puede responder 400, 401, 403, 404, 429, 500 con el cuerpo de error de siempre; cada código está en https://fiscalisto.com/docs/api/errores.md.