retrieve Method - Service Factory Reference

This method retrieves one record of a data model by its ID.

The method's name is retrieveDataModel, where DataModel is the singular pascal-case name of the data model.

Retrieve a Record#

Code
const post = await postModuleService.retrievePost("123")

Parameters#

Pass the ID of the record to retrieve.

Returns#

The method returns the record as an object.


Retrieve a Record's Relations#

Note: This applies to relations between data models of the same module. To retrieve linked records of different modules, use Query.
Code
1const post = await postModuleService.retrievePost("123", {2  relations: ["author"],3})

Parameters#

To retrieve the data model with relations, pass an object with the property relations as the second parameter. relations's value is an array of relation names.

Returns#

The method returns the record as an object.


Select Properties to Retrieve#

Code
1const post = await postModuleService.retrievePost("123", {2  select: ["id", "name"],3})

Parameters#

By default, all of the record's properties are retrieved. To select specific ones, pass a select property in the second object parameter. Its value is an array of property names.

Returns#

The method returns the record as an object.

Was this page helpful?
Ask Anything
Ask any questions about Medusa. Get help with your development.
You can also use the Medusa MCP server in Cursor, VSCode, etc...
FAQ
What is Medusa?
How can I create a module?
How can I create a data model?
How do I create a workflow?
How can I extend a data model in the Product Module?
Recipes
How do I build a marketplace with Medusa?
How do I build digital products with Medusa?
How do I build subscription-based purchases with Medusa?
What other recipes are available in the Medusa documentation?
Chat is cleared on refresh
Line break