{"title":"Read Operation","url":"https://jonas-paprotka.de/docs/dev-itpro/webservices/read-operation/","by":"JOP-AL","license":"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/read-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.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/webservices/read-operation","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","date":"2021-04-01","meta":{"topic":"article"},"outline":[{"level":2,"title":"Method Signature","slug":"method-signature","at":385,"chars":45},{"level":2,"title":"Parameters","slug":"parameters","at":430,"chars":547},{"level":2,"title":"Results","slug":"results","at":977,"chars":336},{"level":2,"title":"Faults","slug":"faults","at":1313,"chars":299},{"level":2,"title":"Usage Example","slug":"usage-example","at":1612,"chars":164},{"level":2,"title":"Related information","slug":"related-information","at":1776,"chars":44}],"text":"Reads a single record.\n> NOTE\n> The signature of an operation changes if the page contains one or more unbound fields in the root content area. If there are unbound fields, then the names from the SourceExpr property for the unbound fields are added as the first parameters to the operation. They are added according to the tab order of the page. For an example, see the Item Journal.\n## Method Signature\n`Entity Read(string no)`\n## Parameters\nParameter|Description\nno|Type: String<br /><br /> The primary key of the requested record.<br /><br /> This argument is a filter on the primary key and returns the first record that matches the filter. When special characters, such as an apostrophe, equal sign, or ampersand, are part of the key, you must enclose the argument with quotation marks.<br /><br /> For example, when you write C\\# code, you should use standard quotation marks for strings and also use additional single quotation marks around a value, such as `\"'A&B'\"`.\n## Results\nResult name|Description\nentity|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 with the given primary key does not exist, then no value is returned. In the .NET Framework, a null reference is returned.\n## Faults\nThis operation does not return a fault when a matching record is not present. Instead, it returns no value. In C\\#, you should test whether the result is a null reference. Otherwise, you may get a NullReferenceException exception.\nFaults are possible if they are generated by the AL code.\n## Usage Example\n```c#\nCustomer customer = new Customer();\ncustomer.Name = \"Customer Name\";\nservice.Create(ref customer);\ncustomer = service.Read(customer.No);\n```\n## Related information\nbasic-page-operations"}