Fetch Contact With ID

Fetch Contact with ID using APIs.

GET /v1/contacts/:id

Curl

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
-X GET https://api.razorpay.com/v1/contacts/cont_00000000000001

Success

{
  "id": "cont_00000000000001",
  "entity": "contact",
  "name": "Gaurav Kumar",
  "contact": "9000090000",
  "email": "[e-mail]",
  "type": "self",
  "reference_id": "Acme Contact ID 12345",
  "batch_id": null,
  "active": true,
  "notes": {
    "notes_key_1":"Tea, Earl Grey, Hot",
    "notes_key_2":"Tea, Earl Grey… decaf."
  },
  "created_at": 1545322986
}

Use this endpoint to retrieve the details of a specific contact.

Curl

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
-X GET https://api.razorpay.com/v1/contacts/cont_00000000000001

Success

{
  "id": "cont_00000000000001",
  "entity": "contact",
  "name": "Gaurav Kumar",
  "contact": "9000090000",
  "email": "[e-mail]",
  "type": "self",
  "reference_id": "Acme Contact ID 12345",
  "batch_id": null,
  "active": true,
  "notes": {
    "notes_key_1":"Tea, Earl Grey, Hot",
    "notes_key_2":"Tea, Earl Grey… decaf."
  },
  "created_at": 1545322986
}

Path Parameters

id · string · required

The unique identifier linked to the contact. For example, cont_00000000000001.

Response Parameters

id · string

The unique identifier linked to the contact. For example, cont_00000000000001.

entity · string

The entity being created. Here, it is contact.

name · string

The contact’s name. For example, Gaurav Kumar.

contact · string

The contact’s phone number. For example, 9000090000.

email · string

The contact’s email address. For example, [e-mail].

type · string

A classification for the contact being created. For example, employee.

reference_id · string

A user-entered reference for the contact. For example, Acme Contact ID 12345.

batch_id · string

This value is returned if the contact was created as part of a bulk upload. For example, batch_00000000000001.

active · boolean

Possible values:

• true (default) : active
• false : inactive

notes · object

Key-value pair that can be used to store additional information about the entity. Maximum 15 key-value pairs, 256 characters (maximum) each. For example, "note_key": "Beam me up Scotty”.

created_at · integer

Timestamp, in Unix, when the contact was created. For example, 1545320320.

Errors

`<sample id> ` is not a valid id.

Code: 4xx

The contact id entered in the request body is invalid/does not exist.

Solution: Enter the correct Contact ID. You can find the Contact ID:

• In the response body of create a Contact API.
• On the RazorpayX Dashboard.