> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.useroot.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.useroot.com/_mcp/server. # Get payer by ID GET https://api.useroot.com/api/payers/{payer_id} Retrieve a specific payer by their unique identifier. Returns complete payer information including all profile data and timestamps. ## Response The response includes: - Unique payer ID - Contact information (name, email) - Complete address information - Metadata associated with the payer - Creation and last update timestamps Reference: https://docs.useroot.com/api-reference/payers-api/get-payer-by-id ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: '[Code Generated] Root - Instant Account to Account Money Movement' version: 1.0.0 paths: /api/payers/{payer_id}: get: operationId: get-payer-by-id summary: Get payer by ID description: >- Retrieve a specific payer by their unique identifier. Returns complete payer information including all profile data and timestamps. ## Response The response includes: - Unique payer ID - Contact information (name, email) - Complete address information - Metadata associated with the payer - Creation and last update timestamps tags: - payersApi parameters: - name: payer_id in: path required: true schema: type: string format: uuid - name: x-api-key in: header description: >- RootPay API key sent in the x-api-key header. Keys are environment-scoped: live_* for production, test_* for sandbox. required: true schema: type: string responses: '200': description: Payer retrieved successfully content: application/json: schema: $ref: '#/components/schemas/Response_PayerResponse_' servers: - url: https://api.useroot.com description: Production components: schemas: CountryCode: type: string enum: - US - GB - IN title: CountryCode PayerResponse: type: object properties: country_code: $ref: '#/components/schemas/CountryCode' country_sub_division: type: - string - 'null' description: State, province, or country subdivision city: type: - string - 'null' description: City or town name address_line: type: - string - 'null' description: Street address, building number, postal code, etc. postal_code: type: - string - 'null' description: Zip or postal code created_at: type: string format: date-time updated_at: type: string format: date-time id: type: string format: uuid name: type: string email: type: string format: email client_metadata: type: object additionalProperties: type: string required: - created_at - updated_at - id - name - email title: PayerResponse Response_PayerResponse_: type: object properties: data: $ref: '#/components/schemas/PayerResponse' warning: type: - string - 'null' required: - data title: Response_PayerResponse_ securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- RootPay API key sent in the x-api-key header. Keys are environment-scoped: live_* for production, test_* for sandbox. ``` ## Examples **Response** ```json { "data": { "created_at": "2024-03-20T12:00:00Z", "updated_at": "2024-03-20T12:00:00Z", "id": "123e4567-e89b-12d3-a456-426614174000", "name": "John Doe", "email": "john.doe@company.com", "country_code": "US", "country_sub_division": "NY", "city": "New York", "address_line": "123 Main Street, Apt 4B", "postal_code": "10001" } } ``` **SDK Code** ```python United States payer import requests url = "https://api.useroot.com/api/payers/payer_id" headers = {"x-api-key": ""} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript United States payer const url = 'https://api.useroot.com/api/payers/payer_id'; const options = {method: 'GET', headers: {'x-api-key': ''}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go United States payer package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.useroot.com/api/payers/payer_id" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("x-api-key", "") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby United States payer require 'uri' require 'net/http' url = URI("https://api.useroot.com/api/payers/payer_id") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["x-api-key"] = '' response = http.request(request) puts response.read_body ``` ```java United States payer import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.useroot.com/api/payers/payer_id") .header("x-api-key", "") .asString(); ``` ```php United States payer request('GET', 'https://api.useroot.com/api/payers/payer_id', [ 'headers' => [ 'x-api-key' => '', ], ]); echo $response->getBody(); ``` ```csharp United States payer using RestSharp; var client = new RestClient("https://api.useroot.com/api/payers/payer_id"); var request = new RestRequest(Method.GET); request.AddHeader("x-api-key", ""); IRestResponse response = client.Execute(request); ``` ```swift United States payer import Foundation let headers = ["x-api-key": ""] let request = NSMutableURLRequest(url: NSURL(string: "https://api.useroot.com/api/payers/payer_id")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```