# ReadByRecId Operation
Reads the record that is identified by the record ID.
## Method Signature
`Entity ReadByRecId(string formattedRecId)`
## Parameters
Parameter|Description
formattedRecId|Type: String<br /><br /> The RecId that is used to read the record.
## Results
Result name|Description
entity|Type: Entity<br /><br /> A variable of a specific object type that represents the page. Contains the latest values that are present on the page.<br /><br /> If the record is not found, then the operation returns null.
## Faults
This operation does not return a fault when a matching record is not present. Instead, it returns null. In C\#, you should test whether the result is a null reference. Otherwise, you may get a NullReferenceException exception.Faults are possible if they are generated by the AL code.
## Usage Example
```c#
public void ReadById(String id)
{
  Customer_Service service = new Customer_Service();
  Customer cust = new Customer();
  service.UseDefaultCredentials = true;
  cust = service.ReadByRecId(id.ToUpper());
}
```
## Related information
basic-page-operations

Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/webservices/readbyrecid-operation, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact. https://jonas-paprotka.de/docs/dev-itpro/webservices/readbyrecid-operation/
