{"_id":"56b10e196d004b170080666f","user":"56abd213d4432d1900eed227","version":{"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","__v":20,"createdAt":"2016-01-29T20:57:39.712Z","releaseDate":"2016-01-29T20:57:39.712Z","categories":["56abd2444e4b730d009eb10e","56abd4c8f25f160d00e17f81","56abd72ff25f160d00e17f84","56b3b8ea9f97020d0012d936","56b3b91ac25dea2b00b0cac9","56b4b2faeed075230097d688","56b4b32deed075230097d689","56b4b37327d9c00d005d6bc4","56b4b3bf3d5f130d00dad120","56b4b3d9eed075230097d68a","56b4b3eb7bccae0d00e9a12e","56b4b4085997532100bc6b61","56fbce6e2885e80e006c855f","5739ed9aad40e23200f674b6","573dd672b3f88f0e00dcae1c","58ad0922e570c62500512a82","58ad092b55018f1900218fda","58e412a5aa544d1b0005f7da","59e62c2a3ccab100263e800a","59e63126b4f8b0002edbe92c"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1"},"__v":3,"parentDoc":null,"category":{"_id":"56b4b2faeed075230097d688","__v":0,"project":"56abd2434e4b730d009eb10a","version":"56abd2434e4b730d009eb10d","pages":[],"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-02-05T14:34:34.496Z","from_sync":false,"order":2,"slug":"contactos","title":"Contactos"},"editedParams":true,"editedParams2":true,"project":"56abd2434e4b730d009eb10a","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-02-02T20:14:17.774Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"name":"Ejemplo consulta exitosa","language":"json","code":"[\n             {\n                \"id\": 1,\n                \"name\": \"Coorporación Alegrate\",\n                \"identification\": \"159.549.847\",\n                \"email\": \"prueba:::at:::alegra.com\",\n                \"phonePrimary\": \"999-99-99\",\n                \"phoneSecondary\": \"\",\n                \"fax\": \"\",\n                \"mobile\": \"(333) 555-55-55\",\n                \"observations\": \"\",\n                \"type\" : [\"client\", \"provider\"],\n                \"address\" : {\n                        \"address\" : \"Calle principal #45\",\n                        \"city\" : \"Barcelona\"\n                },\n                \"seller\": {\n                        \"id\" : \"12\",\n                        \"name\" : \"Diana Giraldo\",\n                        \"identification\" : \"520.526.21\",\n                        \"observations\" : \"Líder de Ventas\"\n                        },\n                \"term\" : \n                        {\n                            \"id\" : 1,\n                            \"name\" : \"8 días\",\n                            \"days\" : 8\n                        },\n                \"priceList\" : {\n                        \"id\" : 5,\n                        \"name\" : \"Distribuidor\"\n                        },\n                \"internalContacts\" : [\n                    {\n                    \"id\" : 1,\n                    \"name\" : \"Andrea\",\n                    \"lastName\" : \"Restrepo\",\n                    \"email\" : \"prueba3@alegra.com\",\n                    \"phone\" : \"999-99-99 ext 105\",\n                    \"mobile\" : \"\",\n                    \"sendNotifications\" : \"yes\"\n                \n                    }\n                ]\n            },\n              {\n                \"id\": 2,\n                \"name\": \"Acrecer\",\n                \"identification\": \"963.654.988\",\n                \"email\": \"prueba2@alegra.com\",\n                \"phonePrimary\": \"111 11 11\",\n                \"phoneSecondary\" : \"\",\n                \"fax\": \"\",\n                \"mobile\": \"(333) 555-55-55\",\n                \"observations\": \"\",\n                \"type\" : [\"client\"],\n                \"seller\": {\n                        \"id\" : \"52\",\n                        \"name\" : \"Carmen López\",\n                        \"identification\" : \"\",\n                        \"observations\" : \"\"\n                        },\n                \"term\" : {\n                            \"id\" : 1,\n                            \"name\" : \"30 días\",\n                            \"days\" : 30\n                        },\n                \"address\" : {\n                    \"address\" : \"Avenida Madison\",\n                    \"city\" : \"New York, USA\"\n                    },\n                \"internalContacts\" : [\n                            {\n                                \"id\" : 9,\n                                \"name\" : \"Lina\",\n                                \"lastName\" : \"Montoya\",\n                                \"email\" : \"prueba4@alegra.com\",\n                                \"phone\" : \"123 45 67 ext 25\",\n                                \"mobile\" : \"(333) 333 33 33\",\n                                \"sendNotifications\" : \"no\"\n                            \n                            }\n                    ],\n                \"priceList\" : null\n                }\n            ]","status":200},{"code":"{ \n\t\"error\": \"El límite de contactos para retornar debe ser menor o igual a 30\",\n\t\"code\" : 903\n}","language":"text","status":400,"name":"Bad Request - Límite sobrepasa máximo permitido"},{"name":"Consulta exitosa con metadatos","status":200,"language":"json","code":"{\n  \"metadata\": {\n  \t\"total\": 45\n  },\n  \"data\": [\n             {\n                \"id\": 1,\n                \"name\": \"Coorporación Alegrate\",\n                \"identification\": \"159.549.847\",\n                \"email\": \"prueba@alegra.com\",\n                \"phonePrimary\": \"999-99-99\",\n                \"phoneSecondary\": \"\",\n                \"fax\": \"\",\n                \"mobile\": \"(333) 555-55-55\",\n                \"observations\": \"\",\n                \"type\" : [\"client\", \"provider\"],\n                \"address\" : {\n                        \"address\" : \"Calle principal #45\",\n                        \"city\" : \"Barcelona\"\n                },\n                \"seller\": {\n                        \"id\" : \"12\",\n                        \"name\" : \"Diana Giraldo\",\n                        \"identification\" : \"520.526.21\",\n                        \"observations\" : \"Líder de Ventas\"\n                        },\n                \"term\" : \n                        {\n                            \"id\" : 1,\n                            \"name\" : \"8 días\",\n                            \"days\" : 8\n                        },\n                \"priceList\" : {\n                        \"id\" : 5,\n                        \"name\" : \"Distribuidor\"\n                        },\n                \"internalContacts\" : [\n                    {\n                    \"id\" : 1,\n                    \"name\" : \"Andrea\",\n                    \"lastName\" : \"Restrepo\",\n                    \"email\" : \"prueba3@alegra.com\",\n                    \"phone\" : \"999-99-99 ext 105\",\n                    \"mobile\" : \"\",\n                    \"sendNotifications\" : \"yes\"\n                \n                    }\n                ]\n            },\n              {\n                \"id\": 2,\n                \"name\": \"Acrecer\",\n                \"identification\": \"963.654.988\",\n                \"email\": \"prueba2@alegra.com\",\n                \"phonePrimary\": \"111 11 11\",\n                \"phoneSecondary\" : \"\",\n                \"fax\": \"\",\n                \"mobile\": \"(333) 555-55-55\",\n                \"observations\": \"\",\n                \"type\" : [\"client\"],\n                \"seller\": {\n                        \"id\" : \"52\",\n                        \"name\" : \"Carmen López\",\n                        \"identification\" : \"\",\n                        \"observations\" : \"\"\n                        },\n                \"term\" : {\n                            \"id\" : 1,\n                            \"name\" : \"30 días\",\n                            \"days\" : 30\n                        },\n                \"address\" : {\n                    \"address\" : \"Avenida Madison\",\n                    \"city\" : \"New York, USA\"\n                    },\n                \"internalContacts\" : [\n                            {\n                                \"id\" : 9,\n                                \"name\" : \"Lina\",\n                                \"lastName\" : \"Montoya\",\n                                \"email\" : \"prueba4@alegra.com\",\n                                \"phone\" : \"123 45 67 ext 25\",\n                                \"mobile\" : \"(333) 333 33 33\",\n                                \"sendNotifications\" : \"no\"\n                            \n                            }\n                    ],\n                \"priceList\" : null\n                }\n            ]\n}"}]},"settings":"","examples":{"codes":[{"code":"curl -v -H \"Accept: application/json\" -H \"Content-type: application/json\" -X GET  https://app.alegra.com/api/v1/contacts/ -u 'usuario@alegra.co:mitoken'","language":"curl"}]},"method":"get","auth":"required","params":[{"_id":"56afd9393c70b01700facf25","ref":"","in":"query","required":false,"desc":"Desde cual contacto se quiere consultar. Por ejemplo para consultar desde el contacto 20, se envía start=20.","default":"0","type":"int","name":"start"},{"_id":"56b0b7da36d2580d002477d7","ref":"","in":"query","required":false,"desc":"Cantidad de contactos a partir del inicio que se desea retornar.  Por defecto retorna 30 contactos. Si este valor es mayor que 30, la aplicación retorna error.","default":"30","type":"int","name":"limit"},{"_id":"56b0b7da36d2580d002477d6","ref":"","in":"query","required":false,"desc":"Orden ascendente o descendente en el cual se quieren retornar los contactos.  Opciones disponibles son DESC o ASC.  Por defecto es ASC (ascendente).","default":"ASC","type":"string","name":"order_direction"},{"_id":"56b0b7da36d2580d002477d5","ref":"","in":"query","required":false,"desc":"Campo por el cual se desea ordenar, las opciones posibles son id, name, identification, email.","default":"name","type":"string","name":"order_field"},{"_id":"56b0b7da36d2580d002477d4","ref":"","in":"query","required":false,"desc":"Cadena de texto que se quiere utilizar para buscar los contactos que en el nombre o en la identificación contienen dicho texto.","default":"","type":"string","name":"query"},{"_id":"56b10e196d004b1700806670","ref":"","in":"query","required":false,"desc":"Filtrar por clientes o proveedores, para filtrar por clientes se debe enviar  'client', para filtrar por proveedores 'provider'.","default":"","type":"string","name":"type"},{"_id":"56fae6fe19b2b80e004999a4","ref":"","in":"query","required":false,"desc":"Incluir en los resultados metadatos. Se debe tener en cuenta que si se envía este parámetro el objeto que retorna la aplicación incluye un atributo \"metadata\" y otro otro atributo \"data\" en donde se envían los contactos. Actualmente la información que se envía en metadata incluye el total de contactos que tiene registrada la empresa.","default":"","type":"boolean","name":"metadata"},{"_id":"5a01e357486b6a002823a1eb","ref":"","in":"query","required":false,"desc":"Filtrar resultados según el nombre del contacto. Se retornarán todos los contactos que en su nombre contenga el valor enviado en este parámetro.","default":"","type":"string","name":"name"},{"_id":"5a01e357486b6a002823a1ea","ref":"","in":"query","required":false,"desc":"Filtrar resultados según la identificación del contacto. Se retornarán todos los contactos que en su identificación contenga el valor enviado en este parámetro.","default":"","type":"string","name":"identification"}],"url":"/contacts/"},"isReference":true,"order":2,"body":"Endpoint que retorna los contactos registrados en la cuenta de Alegra.  Si no se envía límite de contactos, por defecto se envían 30 contactos.  \n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Atención\",\n  \"body\": \"Se debe tener en cuenta que el valor máximo para el atributo limit es 30, si se supera ese valor la aplicación retorna el código de error:\\n```\\n{\\n  \\\"code\\\": 903,\\n  \\\"message\\\" : \\\"El límite debe ser menor o igual a 30\\\"\\n}\\n```\"\n}\n[/block]","excerpt":"Endpoint que permite consultar los contactos registrados en la aplicación","slug":"lista-de-contactos","type":"endpoint","title":"Lista de contactos"}

getLista de contactos

Endpoint que permite consultar los contactos registrados en la aplicación

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Query Params

start:
integer0
Desde cual contacto se quiere consultar. Por ejemplo para consultar desde el contacto 20, se envía start=20.
limit:
integer30
Cantidad de contactos a partir del inicio que se desea retornar. Por defecto retorna 30 contactos. Si este valor es mayor que 30, la aplicación retorna error.
order_direction:
stringASC
Orden ascendente o descendente en el cual se quieren retornar los contactos. Opciones disponibles son DESC o ASC. Por defecto es ASC (ascendente).
order_field:
stringname
Campo por el cual se desea ordenar, las opciones posibles son id, name, identification, email.
query:
string
Cadena de texto que se quiere utilizar para buscar los contactos que en el nombre o en la identificación contienen dicho texto.
type:
string
Filtrar por clientes o proveedores, para filtrar por clientes se debe enviar 'client', para filtrar por proveedores 'provider'.
metadata:
boolean
Incluir en los resultados metadatos. Se debe tener en cuenta que si se envía este parámetro el objeto que retorna la aplicación incluye un atributo "metadata" y otro otro atributo "data" en donde se envían los contactos. Actualmente la información que se envía en metadata incluye el total de contactos que tiene registrada la empresa.
name:
string
Filtrar resultados según el nombre del contacto. Se retornarán todos los contactos que en su nombre contenga el valor enviado en este parámetro.
identification:
string
Filtrar resultados según la identificación del contacto. Se retornarán todos los contactos que en su identificación contenga el valor enviado en este parámetro.

Examples


Result Format


Documentation

Endpoint que retorna los contactos registrados en la cuenta de Alegra. Si no se envía límite de contactos, por defecto se envían 30 contactos. [block:callout] { "type": "warning", "title": "Atención", "body": "Se debe tener en cuenta que el valor máximo para el atributo limit es 30, si se supera ese valor la aplicación retorna el código de error:\n```\n{\n \"code\": 903,\n \"message\" : \"El límite debe ser menor o igual a 30\"\n}\n```" } [/block]

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}