---
agentTools:
projectIndex: https://atendare.readme.io/llms.txt
---
# Listar conversões de um contato
Lista as conversões realizadas por um contato de acordo com a ordem de criação.
A paginação está disponível pelo parâmetro da query {page_index} e {page_size}.
A ordenação de resultados também é suportada.
## Exemplo de resultado (JSON)
```Text JSON
{
"total": 30,
"page_index": 0,
"page_size": 1,
"results": [
{
"id": 18674,
"form_id": 378,
"landingpage_id": null,
"contact_id": 67787,
"utm_id": null,
"utm_source": "google",
"utm_medium": null,
"utm_campaign": null,
"utm_term": null,
"utm_content": null,
"source": 5,
"ip": "12.123.123",
"url": "https://site.com/br/formulario/",
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36",
"gclid": "aABCeeEEFFGdG12221IJHJK3C8BkFEAAYAiAAEgLSZPD_BwE",
"fbclid": "aABCeeEEFFGdG12221IJHJK3C8BkFEAAYAiAAEgLSZPD_BwE",
"creation_date": "2024-10-24T12:56:30Z"
}
]
}
```
***
## Como buscar a última conversão?
Combine os parâmetros `page_size=1`, `sort_field=id` e `sort_order=desc`
**Exemplo:** `https://api.atendare.com/v2/contacts/67787/submissions?page_size=1&sort_field=id&sort_order=desc`
***
## Como buscar a primeira conversão?
Basta limitar a busca para 1 resultado, pois os itens mais antigos são os primeiros.
**Exemplo:** `https://api.atendare.com/v2/contacts/67787/submissions?page_size=1`
***
# Mais detalhes
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "Atendare API - v2",
"version": "2.0"
},
"servers": [
{
"url": "https://api.atendare.com/v2"
}
],
"security": [
{}
],
"paths": {
"/contacts/{id}/submissions": {
"get": {
"summary": "Listar conversões de um contato",
"description": "Lista as conversões realizadas por um contato de acordo com a ordem de criação.\nA paginação está disponível pelo parâmetro da query {page_index} e {page_size}.\nA ordenação de resultados também é suportada.",
"operationId": "contacts-submissions",
"parameters": [
{
"name": "Access-Token",
"in": "header",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "page_index",
"in": "query",
"description": "Para paginação, representa o primeiro elemento da lista.",
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "page_size",
"in": "query",
"description": "Para paginação, define o total de contatos que ira ser retornado em uma lista. O limite é 100",
"schema": {
"type": "integer",
"format": "int32",
"default": 1
}
},
{
"name": "search_text",
"in": "query",
"description": "Termo usado para pesquisar",
"schema": {
"type": "string"
}
},
{
"name": "sort_order",
"in": "query",
"description": "Tipo de ordenação crescente (ASC) ou decrescente (DESC), o padrão é crescente",
"schema": {
"type": "string",
"default": "desc"
}
},
{
"name": "id",
"in": "path",
"description": "id do contato",
"schema": {
"type": "integer",
"format": "int32"
},
"required": true
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n\t\"total\": 30,\n\t\"page_index\": 0,\n\t\"page_size\": 1,\n\t\"results\": [\n\t\t{\n\t\t\t\"id\": 18674,\n\t\t\t\"form_id\": 378,\n\t\t\t\"landingpage_id\": null,\n\t\t\t\"contact_id\": 67787,\n\t\t\t\"utm_id\": null,\n\t\t\t\"utm_source\": \"google\",\n\t\t\t\"utm_medium\": null,\n\t\t\t\"utm_campaign\": null,\n\t\t\t\"utm_term\": null,\n\t\t\t\"utm_content\": null,\n\t\t\t\"source\": 5,\n\t\t\t\"ip\": \"12.123.123\",\n\t\t\t\"url\": \"https://site.com/br/formulario/\",\n\t\t\t\"user_agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36\",\n\t\t\t\"fbclid\": \"aABCeeEEFFGdG12221IJHJK3C8BkFEAAYAiAAEgLSZPD_BwE\",\n \"gclid\": \"aABCeeEEFFGdG12221IJHJK3C8BkFEAAYAiAAEgLSZPD_BwE\",\n\t\t\t\"creation_date\": \"2024-10-24T12:56:30Z\"\n\t\t}\n\t]\n}"
}
},
"schema": {
"type": "object",
"properties": {
"total": {
"type": "integer",
"example": 30,
"default": 0
},
"page_index": {
"type": "integer",
"example": 0,
"default": 0
},
"page_size": {
"type": "integer",
"example": 1,
"default": 0
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"example": 18674,
"default": 0
},
"form_id": {
"type": "integer",
"example": 378,
"default": 0
},
"landingpage_id": {},
"contact_id": {
"type": "integer",
"example": 67787,
"default": 0
},
"utm_id": {},
"utm_source": {
"type": "string",
"example": "google"
},
"utm_medium": {},
"utm_campaign": {},
"utm_term": {},
"utm_content": {},
"source": {
"type": "integer",
"example": 5,
"default": 0
},
"ip": {
"type": "string",
"example": "12.123.123"
},
"url": {
"type": "string",
"example": "https://site.com/br/formulario/"
},
"user_agent": {
"type": "string",
"example": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36"
},
"fbclid": {
"type": "string",
"example": "aABCeeEEFFGdG12221IJHJK3C8BkFEAAYAiAAEgLSZPD_BwE"
},
"gclid": {
"type": "string",
"example": "aABCeeEEFFGdG12221IJHJK3C8BkFEAAYAiAAEgLSZPD_BwE"
},
"creation_date": {
"type": "string",
"example": "2024-10-24T12:56:30Z"
}
}
}
}
}
}
}
}
},
"400": {
"description": "400",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"success\": false\n}"
}
},
"schema": {
"type": "object",
"properties": {
"success": {
"type": "boolean",
"example": false,
"default": true
}
}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true,
"_id": "61f3f7309a3abf0010b92516:674eef528ec434004529c0a8"
}
```