diff --git a/packages/http-client/README.md b/packages/http-client/README.md
index e356f12f..05977d95 100644
--- a/packages/http-client/README.md
+++ b/packages/http-client/README.md
@@ -1,3 +1,15 @@
 # tbdex http client
 
-An HTTP client that can be used to send tbdex messages to PFIs
\ No newline at end of file
+An HTTP client that can be used to send tbdex messages to PFIs
+
+# Installation
+```bash
+npm install @tbdex/http-client
+```
+
+# Usage
+```typescript
+import { TbdexHttpClient } from '@tbdex/http-client'
+
+const offerings = await TbdexHttpClient.getOfferings({ pfiDid: SOME_PFI_DID })
+```
\ No newline at end of file