{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Use this endpoint to retrieve up to 100 contacts that match the requested identifier values for a single identifier type.\n\n`identifier_type` must be a valid identifier type: `email`, `phone_number_id`, `external_id`, or `anonymous_id`.\n\nUse this endpoint instead of the [Search Contacts endpoint](https://www.twilio.com/docs/sendgrid/api-reference/contacts/search-contacts) when you can provide exact identifiers and do not need to include other [Segmentation Query Language (SGQL)](https://www.twilio.com/docs/sendgrid/for-developers/sending-email/segmentation-query-language/) filters when searching.\n\nThis endpoint returns a `200` status code when any contacts match the identifiers you supplied. When searching multiple identifier values in a single request, it is possible that some will match a contact while others will not. When a partially successful search like this is made, the matching contacts are returned in an object and an error message is returned for the identifier values that are not found.\n\nThis endpoint returns a `404` status code when no contacts are found for the provided identifiers.\n\nThis endpoint returns a `400` status code if any searched addresses are invalid.\n\nTwilio SendGrid recommends exporting your contacts regularly as a backup to avoid issues or lost data.\n","properties":{"path":{"type":"object","properties":{"identifier_type":{"allOf":[{"$ref":"#/definitions/IdentifierType1"},{"type":"string"}],"description":"The type of identifier to search for. You can use only one type of identifier per search."}},"required":["identifier_type"],"additionalProperties":false},"body":{"type":"object","description":"","properties":{"identifiers":{"type":"array","description":"One or more more identifier values of the given identifier type to search for in your Marketing Campaigns contacts.","items":{"type":"string"}}},"required":["identifiers"],"examples":[{"identifiers":["contact@example.com"]}]}},"required":["path"],"additionalProperties":false,"definitions":{"IdentifierType1":{"type":"string","enum":["email","phone_number_id","external_id","anonymous_id"]}}},"name":"Get Contacts by Identifiers","id":"sendgrid.mc_contacts.getcontactbyidentifiers","example":{"path":{"identifier_type":"email"}},"maxRequests":1,"summary":false}}