# Can we get the invoice status(Viewed, Not Viewed) through Square Invoice API?

**URL:** <https://developer.squareup.com/forums/t/can-we-get-the-invoice-status-viewed-not-viewed-through-square-invoice-api/11750>\
**Category:** Questions\
**Tags:** orders-api, invoices-api\
**Created:** [January 8, 2024, 6:02am UTC](https://developer.squareup.com/forums/t/can-we-get-the-invoice-status-viewed-not-viewed-through-square-invoice-api/11750 "2024-01-08T06:02:54Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![Ketan\_Chavda](https://avatars.discourse-cdn.com/v4/letter/k/13edae/32.png) [@Ketan\_Chavda](https://developer.squareup.com/forums/u/Ketan_Chavda)\
**Post date:** [January 8, 2024, 6:02am UTC](https://developer.squareup.com/forums/t/can-we-get-the-invoice-status-viewed-not-viewed-through-square-invoice-api/11750/1 "2024-01-08T06:02:54Z")

</div>

Hi,

We are creating invoice through Square Invoice API.

Can we get the status of invoice like “Viewed, Not Viewed” by customer through Invoice API? We are getting the invoice status like “PAID, UNPAID, REFUNDED, CANCELED” through Invoice API. BUT we are not getting invoice status like “Viewed, Not Viewed”.  
How we can get this through Invoice API?

Thanks.

---

<div class="post-metadata">

**Author:** ![Square-Dev-AI](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/square-dev-ai/32/2513_2.png) [@Square-Dev-AI](https://developer.squareup.com/forums/u/Square-Dev-AI)\
**Post date:** [January 8, 2024, 6:03am UTC](https://developer.squareup.com/forums/t/can-we-get-the-invoice-status-viewed-not-viewed-through-square-invoice-api/11750/2 "2024-01-08T06:03:13Z")

</div>

👋 I’m Square Dev AI, here to help answer your question!  
Based on the information you’ve provided, the following documentation will help answer your question:

> **[Pay or Refund Invoices](https://developer.squareup.com/docs/invoices-api/pay-refund-invoices)**
>
> Learn how Square handles invoice payments and how to retrieve and refund an invoice payment.

> **[Invoices API Overview](https://developer.squareup.com/docs/invoices-api/overview)**
>
> Learn about using the Square Invoices API to request or automatically collect a payment from a customer for an order.

> **Additional Documentation**
>
> [Create and Publish Invoices](https://developer.squareup.com/docs/invoices-api/walkthrough)  
> [Invoices API Requirements](https://developer.squareup.com/docs/app-marketplace/requirements/invoices-api)  
> [Create and Publish Invoices](https://developer.squareup.com/docs/invoices-api/create-publish-invoices)

If this documentation helped you find a solution, please check the box indicating that this reply solves the problem.  
Otherwise one of our Developer Advocates will provide additional assistance shortly.

---

<div class="post-metadata">

**Author:** ![Square-Dev-AI](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/square-dev-ai/32/2513_2.png) [@Square-Dev-AI](https://developer.squareup.com/forums/u/Square-Dev-AI)\
**Post date:** [January 8, 2024, 4:51pm UTC](https://developer.squareup.com/forums/t/can-we-get-the-invoice-status-viewed-not-viewed-through-square-invoice-api/11750/3 "2024-01-08T16:51:21Z")

</div>

The Square Invoices API currently does not support retrieving the status of an invoice as “Viewed” or “Not Viewed” by the customer. The API provides the status of the invoice in terms of its payment state, such as “PAID”, “UNPAID”, “REFUNDED”, or “CANCELED”, but it does not track or return information about whether the customer has viewed the invoice.

_This answer was reviewed by @Bryan-Square._

---

<div class="post-metadata">

**Author:** ![Joe\_The\_Gorrilla](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/joe_the_gorrilla/32/11629_2.png) [@Joe\_The\_Gorrilla](https://developer.squareup.com/forums/u/Joe_The_Gorrilla)\
**Post date:** [April 9, 2026, 8:21am UTC](https://developer.squareup.com/forums/t/can-we-get-the-invoice-status-viewed-not-viewed-through-square-invoice-api/11750/4 "2026-04-09T08:21:13Z")

</div>

Square in the infinite wisdom decided we the customers do not require this in an API because, …. well plebs do not need them. so go eat cake.

If you want this functionality, use a link shortening service like [Short.io](http://Short.io) etc and send the shortened link to your clients (not the ugly links that square generates), you can then call the short API to see human clicks and timestamps. Hope this helps.