Skip to main content
GET
http://api.gu1.ai
/
entities
Listar Métodos de Pago
curl --request GET \
  --url http://api.gu1.ai/entities \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "entities": [
    {}
  ],
  "pagination": {}
}

Descripción General

Recupera una lista de entidades de método de pago con filtrado opcional por propietario, tipo u otros criterios.

Endpoint

GET http://api.gu1.ai/entities?entityType=payment_method

Autenticación

Requiere una clave API válida en el encabezado de Autorización:
Authorization: Bearer YOUR_API_KEY

Parámetros de Consulta

entityType
string
required
Debe ser "payment_method" para filtrar métodos de pago
relationshipWith
string
Filtrar por relación con otra entidad (ej. UUID del propietario persona o empresa)
limit
number
Número de resultados a devolver (predeterminado: 50, máx: 100)
offset
number
Número de resultados a omitir para paginación (predeterminado: 0)
sortBy
string
Campo por el que ordenar: createdAt, updatedAt, riskScore
sortOrder
string
Orden de clasificación: asc o desc (predeterminado: desc)

Ejemplos de Solicitudes

Listar Todos los Métodos de Pago

curl -X GET "http://api.gu1.ai/entities?entityType=payment_method" \
  -H "Authorization: Bearer YOUR_API_KEY"

Listar Métodos de Pago para una Persona

curl -X GET "http://api.gu1.ai/entities?entityType=payment_method&relationshipWith=person-uuid-123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Respuesta

success
boolean
Si la solicitud fue exitosa
entities
array
Array de entidades de método de pago
pagination
object
Información de paginación

Ejemplo de Respuesta

{
  "success": true,
  "entities": [
    {
      "id": "payment-method-uuid-123",
      "entityType": "payment_method",
      "entityData": {
        "paymentMethod": {
          "type": "credit_card",
          "last4": "4242",
          "brand": "visa",
          "holderName": "John Doe"
        }
      },
      "riskScore": 15,
      "createdAt": "2024-01-15T10:00:00.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 50,
    "offset": 0,
    "hasMore": false
  }
}

Ver También