---
updatedAt: 2026-05-13T09:04:05.000Z
---
# Get conversation IDs by author network handle and network
Get the IDs for conversations associated with the specified author by the `networkhandle` passed in for the specified source network
## Details
Returns the IDs for conversations associated with the specified author by the `networkhandle` passed in for the specified source network. Because handles and user names are not globally unique across a source network, this call can return conversations belonging to multiple, unrelated authors.
Use this for a `networktype` of "facebook", or "instagram" where there is a single, default instance of the network. If the `networktype` is "lithium" or "crm", where there can be multiple instances of the network, use:
`/authors/networks/networktype/instances/networkinstance/handles/networkhandle/conversations`
The call returns new conversations and conversations with specific modifications.
This call returns all conversations associated with the author record passed. This means that if you pass a handle or ID for a Instagram account, for example, you could also retrieve conversations associated with the author that originated on Facebook, or another source network.
Specify the time period with `startEpochMillis` and `endEpochMillis`. The maximum range allowed is 24 hours. If the duration specified is more than 24 hours, only 24 hours worth of changed data is returned. If you omit either `startEpochMillis` or `endEpochMillis`, the API sets the range so that the call retrieves 24 hours worth of data.
> 👍 Tip
>
> For best results, use this call for data created after June 30, 2014.
# Related endpoints
| Action | Endpoint |
| ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| GET | [/authors/lswUuid/conversations](https://developer.khoros.com/khoroscaredevdocs/reference/authors_lswuuid_conversations)
Get IDs for conversations associated with the specified author by unique Care author ID for a 24-hour period |
| GET | [/authors/networks/{networktype}/ids/{networkid}/conversations](https://developer.khoros.com/khoroscaredevdocs/reference/authorsnetworksnetworktypeidsnetworkidconversations)
Get IDs for conversations associated with the specified author by source network ID for a 24-hour period |
| GET | [/authors/networks/{networktype}/instances/{networkinstance}/ids/{networkid}/conversations](https://developer.khoros.com/khoroscaredevdocs/reference/authorsnetworksnetworktypeinstancesnetworkinstanceidsnetworkidconversations)
Get the IDs for conversations associated with the specified author by source network ID for a 24-hour period |
| GET | [/authors/networks/{networktype}/instances/{networkinstance}/handles/{networkhandle}/conversations](https://developer.khoros.com/khoroscaredevdocs/reference/authorsnetworksnetworktypeinstancesnetworkinstancehandlesnetworkhandleconversations)
Get the IDs for conversations associated with the specified author by the `networkhandle` passed in for the specified instance of a network |
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "author-api-v2",
"version": "1.1"
},
"servers": [
{
"url": "https://{instance}.response.lithium.com/api/v2/authors",
"variables": {
"instance": {
"default": "instance"
}
}
}
],
"security": [
{}
],
"paths": {
"/networks/{networktype}/handles/{networkhandle}/conversations": {
"get": {
"summary": "Get conversation IDs by author network handle and network",
"description": "Get the IDs for conversations associated with the specified author by the `networkhandle` passed in for the specified source network",
"operationId": "authorsnetworksnetworktypehandlesnetworkhandleconversations",
"parameters": [
{
"name": "networktype",
"in": "path",
"description": "The type of network that manages content created by or about an author. Supported values are: \"instagram\", \"facebook\", \"googleplus\", \"lithium\", \"crm\"
For a `networktype` of value \"lithium\" or \"crm\" you must also pass the `networkinstance`, because these types of networks can have multiple instances as opposed to Instagram, Facebook, or Google+ that have only a single, default network.
The Author API supports \"instagram\", \"facebook\", \"googleplus\", \"lithium\", and \"crm\" only as values for `networktype`.",
"schema": {
"type": "string"
},
"required": true
},
{
"name": "networkhandle",
"in": "path",
"description": "The external identification for the author, such as a Community or a Instagram handle. This is different than the `networkid` generated by a network for internal use.",
"schema": {
"type": "string"
},
"required": true
},
{
"name": "startEpochMillis",
"in": "query",
"description": "The start time of the query period specified as milliseconds since the UNIX Epoch",
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "endEpochMillis",
"in": "query",
"description": "The end of of the query period specified as milliseconds since the UNIX Epoch",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"status\": \"success\",\n \"data\": [\n \"c2ff4ee1-3e22-47f2-8369-92d53a82078b\",\n \"f6e1be9b-261b-470f-a148-b80d2b31b2d1\",\n \"7a021890-7545-441a-b4e0-b35af56f255a\",\n \"afd4c477-a13e-4982-a871-9835b3669d43\",\n \"56e83284-f64b-4eb3-b89b-828757d086de\",\n \"8d03b794-6956-4319-996d-9213420f0c4e\",\n \"4f4a033d-55e1-4103-b471-55aaa9a6f2c3\",\n \"9edc56ac-7783-4479-8466-c9f3dcc6012b\",\n \"81fa55f5-a601-4086-a0d6-a3442e89f35a\",\n \"6faa6c82-51d9-4259-b7cc-f7769881da72\",\n \"b99cc560-af41-4ec8-8991-9aab260ec064\",\n \"7d5bbbf4-03d0-4876-b731-9c520b99c1b7\",\n \"f3b229fb-871a-4898-a1b1-4fa0f59fd064\",\n \"accd94e3-a8e1-405b-b06b-d79abe12cc0e\",\n \"1311f6e0-0e3f-4d84-8b30-5c5061b26837\",\n \"fd2f5e75-bdc5-43b7-a530-9a6f1e0cfb70\",\n \"09b599b2-3bef-4284-b690-98761582703d\",\n \"46716f94-7c43-49c4-b18c-2bd79a865044\",\n \"5814ac2d-f29e-412f-8ab1-c9d23d7450b7\",\n \"d4e973e5-3363-4512-bb2a-0d813dd63220\",\n \"9c7dabf6-f28f-4c8d-93eb-bb5af1a92580\"\n ]\n}"
}
},
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "success"
},
"data": {
"type": "array",
"items": {
"type": "string",
"example": "c2ff4ee1-3e22-47f2-8369-92d53a82078b"
}
}
}
}
}
}
},
"400": {
"description": "400",
"content": {
"application/json": {
"examples": {
"Unsupported network type": {
"value": "{\n \"status\": \"fail\",\n \"message\": \"Error parsing HTTP body. Error details: Unsupported author data container format! (through reference chain: Person[\\\"handles\\\"])\"\n}"
}
},
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "fail"
},
"message": {
"type": "string",
"example": "Error parsing HTTP body. Error details: Unsupported author data container format! (through reference chain: Person[\"handles\"])"
}
}
}
}
}
}
},
"deprecated": false,
"security": [],
"x-readme": {
"code-samples": [
{
"language": "curl",
"code": "curl -L -u [USERNAME]:[PASSWORD] 'https://your_social_response_instance.lithium.com/api/v2/authors/networks/instagram/handles/Anusuya_user/conversations'"
}
],
"samples-languages": [
"curl"
]
}
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": false,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```