Skip to main content

Directory Search

The directory search API calls can be made by any registered client. By default, only public, unsuppressed directory information will be provided. For access to additional attributes or suppressed information, email identity@tamu.edu.

The default result format for all calls is JSON, though you can explicitly specify either a JSON or XML format.

Heads Up

All requests must be signed and dated. Note the trailing slashes on all URLs.

Search by UIN​

Searching by UIN is only available if you have an approved data access request on file that includes access to the UIN.

The following paths can be used to search for an entry by UIN:

https://mqs.tamu.edu/rest/directory/uin/<UIN>/
https://mqs.tamu.edu/rest/directory/uin/<UIN>/json/
https://mqs.tamu.edu/rest/directory/uin/<UIN>/xml/

where <UIN> would be replaced by the person’s UIN.

Search by NetID​

The following paths can be used to search for an entry by NetID:

https://mqs.tamu.edu/rest/directory/netid/<NetID>/
https://mqs.tamu.edu/rest/directory/netid/<NetID>/json/
https://mqs.tamu.edu/rest/directory/netid/<NetID>/xml/

where <NetID> would be replaced by the person’s NetID.

Search by searchMailbox​

The following paths can be used to search for an entry by searchMailbox:

https://mqs.tamu.edu/rest/directory/smb/<searchMailbox>/
https://mqs.tamu.edu/rest/directory/smb/<searchMailbox>/json/
https://mqs.tamu.edu/rest/directory/smb/<searchMailbox>/xml/

where <searchMailbox> would be replaced by the person’s searchMailbox.

Search by UID​

The following paths can be used to search for an entry by UID:

https://mqs.tamu.edu/rest/directory/uid/<UID>/
https://mqs.tamu.edu/rest/directory/uid/<UID>/json/
https://mqs.tamu.edu/rest/directory/uid/<UID>/xml/

where <UID> would be replaced by the person’s UID.