> ## Documentation Index
> Fetch the complete documentation index at: https://help.impactu.colav.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Patentes de una afiliación

> Lista de forma paginada las patentes asociadas a una afiliación.

## Parámetros de ruta

**affiliation\_type** `string` *required*

Tipo de afiliación: `institution`, `faculty`, `department` o `group`.

**affiliation\_id** `string` *required*

Identificador de la afiliación.

## Parámetros de consulta

**max** `integer` (default: 10)

Resultados por página (1 a 250).

**page** `integer` (default: 1)

Número de página (mínimo 1).

**sort** `string` (default: citations\_desc)

Criterio de ordenamiento ascendente y descendente, por ejemplo
`citations_desc`, `products_asc` o `alphabetical_desc`.

**sort** `string` (default: citations\_desc)

Ordenamiento con el formato `campo_direccion`, donde la dirección es `asc` o
`desc`. Campos disponibles: `citations` (citas), `alphabetical` (por título) y
`year` (año de publicación). Ejemplo: `year_desc`.

**view** `string` (default: full)

Nivel de detalle de la respuesta. `full` devuelve todos los campos. `summary`
devuelve solo los campos principales de la entidad y, en productos, patentes y
proyectos, recorta la lista de autores a 10. Otro valor responde `400`.

> [!NOTE]
>
> Si no envías `max`, `page` ni `sort`, se aplican `max=10`, `page=1` y
> `sort=citations_desc`. Si envías `max` y `page` sin `sort`, se aplica
> `sort=citations_desc`.

## Respuesta

**data** `array`

Lista de patentes de la afiliación.

**propiedades de cada patente**

**id** `string`

Identificador de la patente.

**title** `string | null`

Título principal.

**titles** `object[]`

Títulos por fuente (`title`, `lang`, `source`, `provenance`).

**language** `string | null`

Idioma.

**authors** `object[]`

Autores con sus afiliaciones y clasificaciones.

**authors\_count** `integer | null`

Cantidad de autores.

**groups** `object[]`

Grupos de investigación asociados, con citas y clasificaciones.

**types** `object[]`

Tipos de la patente por fuente (`type`, `source`, `provenance`).

**product\_types** `object[]`

Tipos normalizados por ImpactU (`name`, `source`).

**ranking** `object[]`

Clasificaciones de la patente.

**external\_ids** `object[]`

Identificadores externos (`id`, `source`, `provenance`).

**external\_urls** `object[]`

Enlaces externos (`url`, `source`).

**updated** `object[]`

Última actualización por fuente (`source`, `time` en segundos Unix).

**meta** `object`

Metadatos de la respuesta.

**propiedades**

**count** `integer`

Total de resultados que cumplen la consulta.

**page** `integer`

Página actual.

**size** `integer`

Cantidad de resultados devueltos en esta página.

**db\_response\_time\_ms** `integer`

Tiempo de respuesta de la base de datos en milisegundos.

**cursor** `object`

**propiedades**

**next** `string | null`

URL de la página siguiente.

**previous** `string | null`

URL de la página anterior.

```json 200 theme={null}
{
  "data": [
    {
      "authors": [
        {
          "affiliations": [
            {
              "id": "COL0000001",
              "name": "Grupo de Investigación Ejemplo",
              "types": [{"source": "scienti", "type": "group"}],
              "years": []
            }
          ],
          "full_name": "María Ejemplo García",
          "id": "0000000001"
        }
      ],
      "authors_count": 1,
      "external_ids": [{"id": "0000000001-5494", "provenance": "minciencias", "source": "scienti"}],
      "external_urls": [],
      "groups": [{"id": "COL0000001", "name": "Grupo de Investigación Ejemplo"}],
      "id": "6ab847915418a51e32855ab0",
      "language": "es",
      "product_types": [{"name": "Patente de invención", "source": "minciencias"}],
      "ranking": [{"date": 1383195600, "rank": "PIV-PA4", "source": "minciencias"}],
      "title": "Proceso continuo para la elaboración de nanopartículas y nanopartículas obtenidas mediante dicho proceso",
      "titles": [
        {
          "lang": "es",
          "source": "minciencias",
          "title": "Proceso continuo para la elaboración de nanopartículas y nanopartículas obtenidas mediante dicho proceso"
        }
      ],
      "types": [{"level": 1, "provenance": "minciencias", "source": "minciencias", "type": "Patente de invención"}],
      "updated": [{"source": "minciencias", "time": 1790461841}]
    },
    {
      "authors": [
        {
          "affiliations": [
            {
              "id": "COL0000001",
              "name": "Grupo de Investigación Ejemplo",
              "types": [{"source": "scienti", "type": "group"}],
              "years": []
            }
          ],
          "full_name": "María Ejemplo García",
          "id": "0000000001"
        }
      ],
      "authors_count": 1,
      "external_ids": [{"id": "0000000001-5509", "provenance": "minciencias", "source": "scienti"}],
      "external_urls": [],
      "groups": [{"id": "COL0000001", "name": "Grupo de Investigación Ejemplo"}],
      "id": "6ab847915418a51e32855afb",
      "language": "es",
      "product_types": [{"name": "Patente de invención", "source": "minciencias"}],
      "ranking": [{"date": 1383195600, "rank": "PIV-PA4", "source": "minciencias"}],
      "title": "Proceso de Microencapsulacion de Sustancias Volatiles",
      "titles": [{"lang": "es", "source": "minciencias", "title": "Proceso de Microencapsulacion de Sustancias Volatiles"}],
      "types": [{"level": 1, "provenance": "minciencias", "source": "minciencias", "type": "Patente de invención"}],
      "updated": [{"source": "minciencias", "time": 1790461841}]
    }
  ],
  "meta": {
    "count": 85,
    "cursor": {
      "next": "https://api.dev.impactu.colav.co/affiliation/institution/example-institution-id/research/patents?max=2&page=2",
      "previous": null
    },
    "db_response_time_ms": 25,
    "page": 1,
    "size": 2
  }
}
```

```json 400 theme={null}
{
  "error": "1 validation error for QueryParams\nmax\n  Input should be greater than or equal to 1 [type=greater_than_equal, input_value='0', input_type=str]\n    For further i…"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.